跳至主要内容

創建收款單(泰國)

創建泰銖(THB)收款訂單接口。

請求資訊

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

請求參數

參數名必選類型說明
platform_idString(7)商戶 ID
service_idString(7)服務 ID
payment_cl_idString(32)商戶訂單號
amountInteger(10)金額(分)
notify_urlString(256)交易結果通知地址
nameString(64)匯款人戶名(實名制渠道必填)
bank_nameString(6)匯款人銀行,SVC0044SVC0045SVC0046SVC0065 時必填,銀行列表
last_numberString(6)匯款人帳戶
request_timeInteger(10)請求時間(秒)
signString(32)訂單簽名

請求示例

{
"amount": "50000000",
"bank_name": "KBANK",
"last_number": "1234567890",
"name": "test_name",
"notify_url": "https://xxx.xx/notification",
"payment_cl_id": "DEVPM00014581",
"platform_id": "PF0002",
"request_time": "1595504136",
"service_id": "SVC0044",
"sign": "c81634c1769044eac9e9628a2292f557"
}

返回示例

成功返回

{
"error_code": "0000",
"data": {
"link": "http://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB"
}
}

錯誤返回示例

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

返回參數說明

參數名類型說明
error_codeString錯誤碼
error_msgString錯誤訊息(error_code 不為 "0000" 時返回)
linkString訂單收銀地址
amountInt提單金額

備註

  • 商戶 ID 為系統分配之唯一識別,如尚未取得請聯繫系統人員
  • 服務 ID 請填入:
    • SVC0044 TrueMoney(泰國通道)
    • SVC0045 銀行網關(泰國通道)
    • SVC0046 銀行掃碼(泰國通道)
    • SVC0065 PromptPay(泰國通道)
    • 參考 服務列表
  • bank_name 請填入,參考 銀行列表
  • 交易金額單位為泰銖(分),請乘以 100 傳入,例如收款 10000.00 請傳值 1000000
  • 請求時間使用 Unix timestamp,單位為秒
  • 交易結果將通知至 notify_url,請傳入可公開訪問之完整地址(僅支援 http 與 https 協議),參數規範見 交易結果通知