創建收款單（台灣）

創建新台幣（TWD）收款訂單接口。

請求資訊

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

請求參數

參數名	必選	類型	說明
platform_id	是	String(7)	商戶 ID
service_id	是	String(7)	服務 ID
payment_cl_id	是	String(32)	商戶訂單號
amount	是	Integer(10)	金額（分）
last_numbers	是	List of String	匯款帳號末五碼（可輸入最小一組最多十組的帳號）
bank_code	否	String(3)	銀行代碼
name	是	String(32)	匯款人姓名
notify_url	是	String(256)	交易結果通知地址
request_time	是	Integer(10)	請求時間（秒）
sign	是	String(32)	訂單簽名

請求示例

{
  "amount": 48389,
  "lastNumbers": [
    "12345",
    "67890",
    "11111"
  ],
  "notifyUrl": "http://localhost:54725/gateway/test-notification",
  "paymentClId": "test_tw_card_1766005863_25",
  "platformId": "PF0003",
  "requestTime": 1766005863,
  "serviceId": "SVC0025",
  "sign": "fd2b863acdb75d67fe938e33d4e56b02"
}

返回示例

成功返回

{
  "data": {
    "link": "http://localhost:8889/payment/index.html?token=eyJhbGciOiJ",
    "paymentInfo": {
      "amount": 48389,
      "displayAmount": 48389,
      "paymentClId": "test_tw_card_1766005863_25",
      "paymentId": "DEVPM00000018",
      "receiver": {
        "bankBranch": "",
        "bankLogo": "",
        "bankName": "臺灣企銀",
        "cardName": "test",
        "cardNumber": "12345666"
      },
      "token": "无须附言"
    }
  },
  "errorCode": "0000"
}

錯誤返回示例

{
  "error_code": "0004",
  "error_msg": "验签错误!"
}

返回參數說明

參數名	類型	說明
error_code	String	錯誤碼
error_msg	String	錯誤訊息（error_code 不為 "0000" 時返回）
link	String	訂單收銀地址

備註

• 商戶 ID 為系統分配之唯一識別，如尚未取得請聯繫系統人員
• 服務 ID 請填入：
  • SVC0025（ATM 支付）
  • 更多請參考 service_id 列表
• 交易金額單位為台幣（分）
• 請求時間使用 Unix timestamp，單位為秒
• 交易結果將通知至 notify_url，請傳入可公開訪問之完整地址（僅支援 http 與 https 協議），參數規範見 交易結果通知