跳到主要内容

建立收款單（台灣）

建立新台幣（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匯款帳號，每組最多20碼數字（最少一組，最多十組）；亦可在帳號前加 3 碼銀行代碼與連字號，格式 銀行代碼-帳號（例 008-123456789）
notify_url是String(256)交易結果通知地址
request_time是Integer(10)請求時間（秒）
sign_type否String(16)簽名類型，固定值 HMAC-SHA256
sign是String(32|64)訂單簽名

服務 ID 與欄位規則​

強制必填​

服務 ID名稱必填欄位
SVC0025ATM支付必填 name + last_numbers；缺欄位訂單將導入收銀台補填頁

上游風控建議傳入（可選但建議帶真實值）​

服務 ID名稱建議傳入
SVC0083超商代碼name + last_numbers：上游風控材料，未傳時系統會以 mock 值替代，可能影響審核通過率

後端不檢核（可不傳）​

服務 ID名稱備註
SVC0078一卡通此服務由我方自有掛碼處理，name、bank_code、last_numbers 均不送上游
SVC0079全支付同上
SVC0080街口支付同上

通用備註​

  • bank_code 為保留欄位，台灣代收所有服務上游皆不使用，傳入僅作後台留存
  • 「強制必填」與「上游風控建議」服務的欄位語意：name = 匯款人姓名、last_numbers = 匯款帳號末碼陣列（每組最多 20 碼純數字，1-10 組）

請求範例​

{
  "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..."
}

回傳範例​

成功回傳​

{
  "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，參數規範請見 交易結果通知