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)	Sender's 3-digit bank code, see Sender Account Guide
last_numbers	Depends on service	List of String	Sender's bank account number(s), 1–10 entries, see Sender Account Guide
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

Service ID	Name	name	last_numbers
SVC0025	ATM Payment	Required	Required
SVC0090	Virtual Account	Required	Required
SVC0083	CVS Code	Recommended	Recommended
SVC0078	iPASS MONEY	Not required	Not required
SVC0079	PXPay Plus	Not required	Not required
SVC0080	JKOPay	Not required	Not required
SVC0085	Alipay	Not required	Not required

• name = sender's name; last_numbers = sender's account number
• If a required field is missing, the order is routed to the cashier completion page
• For SVC0083, default values are used when omitted — passing real values is recommended

Sender Account (last_numbers) Format

The field is an array; pass 1–10 entries. Both formats are accepted:

Format	Example	Notes
Bank code + account (recommended)	"013-699520035871"	3-digit bank code + hyphen + account number
Account only	"699520035871"	1–20 digits; pass the bank code separately in bank_code

• SVC0090 requires a bank code — use either format above
• Bank codes are the 3-digit Taiwan FISC institution codes, e.g. 004 Bank of Taiwan, 008 Hua Nan, 013 Cathay United, 053 Taichung Bank, 822 CTBC, 824 LINE Bank
• Do not pass the bank name; the system resolves it from the code

Request Example

{
  "platform_id": "DEMO01",
  "service_id": "SVC0025",
  "payment_cl_id": "order_20260112001",
  "amount": 10000,
  "name": "Wang Xiaoming",
  "last_numbers": [
    "013-699520035871",
    "822-193540226057"
  ],
  "notify_url": "https://merchant.example.com/notify",
  "request_time": 1768262400,
  "sign_type": "HMAC-SHA256",
  "sign": "d2e4..."
}

SVC0090 Virtual Account

{
  "platform_id": "DEMO01",
  "service_id": "SVC0090",
  "payment_cl_id": "order_20260112003",
  "amount": 10000,
  "name": "Wang Xiaoming",
  "last_numbers": [
    "013-699520035871"
  ],
  "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