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). A 3-digit bank code prefix with a hyphen is also accepted, in the format bankCode-account (e.g. 008-123456789).
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, fixed value HMAC-SHA256
sign	Yes	String(32|64)	Order Signature

Service IDs & Field Rules

Required

Service ID	Name	Required Fields
SVC0025	ATM Payment	Required: name + last_numbers. Missing fields will route the order to the cashier completion page.

Recommended for Upstream Risk Control (optional but should pass real values)

Service ID	Name	Recommended Fields
SVC0083	CVS Code	name + last_numbers: used by upstream risk control. The system falls back to mock values if absent, which may reduce approval rate.

Not Validated by Backend (may be omitted)

Service ID	Name	Note
SVC0078	iPASS MONEY	Handled via our in-house card pool; name, bank_code, and last_numbers are not forwarded to upstream.
SVC0079	PXPay Plus	Same as above.
SVC0080	JKOPay	Same as above.

General Notes

• bank_code is a reserved field. None of the Taiwan deposit services forward it to upstream; values are kept only for internal records.
• Field semantics for "Required" and "Recommended" services: name = remitter name; last_numbers = array of remittance account last digits (each up to 20 numeric digits, 1–10 entries).

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