跳到主要内容

創建收款單(菲律賓)

創建菲律賓披索(PHP)收款訂單接口。

請求資訊

  • 請求 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)交易結果通知地址
request_timeInteger(10)請求時間(秒)
signString(32)訂單簽名

請求示例

{
"amount": "50000",
"notify_url": "https://xxx.xx/notification",
"payment_cl_id": "DEVPM00014581",
"platform_id": "PF0002",
"request_time": "1595504136",
"service_id": "SVC0021",
"sign": "c81634c1769044eac9e9628a2292f557"
}

返回示例

成功返回

{
"error_code": "0000",
"data": {
"link": "http://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB%2FayV7EO9S1EQ%3D%3D"
}
}

錯誤返回示例

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

返回參數說明

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

備註

  • 商戶 ID 為系統分配之唯一識別,如尚未取得請聯繫系統人員
  • 服務 ID 請填入:
    • SVC0020 GCASH PAY(菲律賓通道)
    • SVC0021 MAYA PAY(菲律賓通道)
    • SVC0066 GOTYME QR(菲律賓通道)
    • 參考 service_id 列表
  • 交易金額單位為菲律賓披索(分),請乘以 100 傳入,例如收款 10000.00 請傳值 1000000
  • 請求時間使用 Unix timestamp,單位為秒
  • 交易結果將通知至 notify_url,請傳入可公開訪問之完整地址(僅支援 http 與 https 協議),參數規範見 交易結果通知