Skip to main content

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

ParameterRequiredTypeDescription
platform_idYesString(6)Merchant ID
service_idYesString(7)Service ID
payment_cl_idYesString(32)Merchant Order ID
amountYesInteger(10)Amount (in cents)
nameDepends on serviceString(16)Sender's name
bank_codeDepends on serviceString(3)Bank code
last_numbersDepends on serviceList of StringSender's account number(s), each up to 20 digits (minimum 1, maximum 10)
notify_urlYesString(256)Callback URL for transaction result
request_timeYesInteger(10)Request time (seconds)
sign_typeNoString(16)Signature type: HMAC-SHA256 (recommended) or MD5 (default)
signYesString(32|64)Order Signature

Service ID

Service IDNameRequired Parameters Note
SVC0025ATM PaymentRequired: last_numbers; Optional: name
SVC0076JKOOptional: name, bank_code, last_numbers
SVC0078iPASS MONEYOptional: name, bank_code, last_numbers
SVC0079PXPay PlusOptional: name, bank_code, last_numbers
SVC0080JKOPayOptional: name, bank_code, last_numbers
SVC0083CVS CodeAll 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