Create Deposit Order (Taiwan)
API for creating New Taiwan Dollar (TWD) deposit orders.
Request Information
- Request URL:
/gateway/api/v2/payments - Method:
POST - Content-Type:
application/json;charset=utf-8
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| platform_id | Yes | String(6) | Merchant ID |
| service_id | Yes | String(7) | Service ID |
| payment_cl_id | Yes | String(32) | Merchant Order ID |
| amount | Yes | Integer(10) | Amount (in cents) |
| name | Depends on service | String(16) | Sender's name |
| bank_code | Depends on service | String(3) | Bank code |
| last_numbers | Depends on service | List of String | Sender's account number(s), each up to 20 digits (minimum 1, maximum 10) |
| notify_url | Yes | String(256) | Callback URL for transaction result |
| request_time | Yes | Integer(10) | Request time (seconds) |
| sign_type | No | String(16) | Signature type: HMAC-SHA256 (recommended) or MD5 (default) |
| sign | Yes | String(32|64) | Order Signature |
Service ID
| Service ID | Name | Required Parameters Note |
|---|---|---|
SVC0025 | ATM Payment | Required: last_numbers; Optional: name |
SVC0076 | JKO | Optional: name, bank_code, last_numbers |
SVC0078 | iPASS MONEY | Optional: name, bank_code, last_numbers |
SVC0079 | PXPay Plus | Optional: name, bank_code, last_numbers |
SVC0080 | JKOPay | Optional: name, bank_code, last_numbers |
SVC0083 | CVS Code | All optional parameters are not required |
Request Example
{
"platform_id": "DEMO01",
"service_id": "SVC0025",
"payment_cl_id": "order_20260112001",
"amount": 10000,
"last_numbers": [
"12345",
"67890"
],
"notify_url": "https://merchant.example.com/notify",
"request_time": 1768262400,
"sign_type": "HMAC-SHA256",
"sign": "d2e4..."
}
Response Example
Successful Response
{
"error_code": "0000",
"data": {
"link": "https://pay.example.com/cashier/DEMOPM0123456",
"payment_id": "DEMOPM0123456",
"payment_cl_id": "order_20260112001",
"amount": 10000
}
}
Remarks
- Transaction amount is in New Taiwan Dollar (cents), please multiply by 100 before sending
- Request time uses Unix timestamp in seconds
- Transaction results will be sent to
notify_url, see Deposit Notification for parameter specifications