建立收款單（台灣）

建立新台幣（TWD）收款訂單 API。

請求資訊

請求 URL： /gateway/api/v2/payments
請求方式： POST
Content-Type： application/json;charset=utf-8

請求參數

參數名稱	必填	型別	說明
platform_id	是	String(6)	商戶 ID
service_id	是	String(7)	服務 ID
payment_cl_id	是	String(32)	商戶訂單號
amount	是	Integer(10)	金額（分）
name	視服務	String(16)	匯款人戶名
bank_code	視服務	String(3)	銀行代碼
last_numbers	視服務	List of String	匯款帳號（可輸入最小一組最多
notify_url	是	String(256)	交易結果通知地址
request_time	是	Integer(10)	請求時間（秒）
sign_type	否	String(16)	簽名類型：`HMAC-SHA256`（推薦）或 `MD5`（預設）
sign	是	String(32\|64)	訂單簽名

服務 ID

服務 ID	名稱	必填參數說明
`SVC0025`	ATM支付	可選填 `name`, `last_numbers`
`SVC0076`	JKO	可選填 `name`、`bank_code`、`last_numbers`
`SVC0078`	一卡通	可選填 `name`、`bank_code`、`last_numbers`
`SVC0079`	全支付	可選填 `name`、`bank_code`、`last_numbers`
`SVC0080`	街口支付	可選填 `name`、`bank_code`、`last_numbers`
`SVC0083`	超商代碼	所有選填參數皆不需要傳入

請求範例

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

回傳範例

成功回傳

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 10000
  }
}

備註

交易金額單位為新台幣（分），請乘以 100 帶入
請求時間使用 Unix timestamp，單位為秒
交易結果將通知至 notify_url，參數規範請見交易結果通知

請求資訊​

請求參數​

服務 ID​

請求範例​

回傳範例​

成功回傳​

備註​

請求資訊

請求參數

服務 ID

請求範例

回傳範例

成功回傳

備註