創建收款單(菲律賓)
創建菲律賓披索(PHP)收款訂單接口。
請求資訊
- 請求 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) | 金額(分) |
| notify_url | 是 | String(256) | 交易結果通知地址 |
| request_time | 是 | Integer(10) | 請求時間(秒) |
| sign | 是 | String(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_code | String | 錯誤碼 |
| error_msg | String | 錯誤訊息(error_code 不為 "0000" 時返回) |
| link | String | 訂單收銀地址 |
| amount | Int | 提單金額 |
備註
- 商戶 ID 為系統分配之唯一識別,如尚未取得請聯繫系統人員
- 服務 ID 請填入:
SVC0020GCASH PAY(菲律賓通道)SVC0021MAYA PAY(菲律賓通道)SVC0066GOTYME QR(菲律賓通道)- 參考 service_id 列表
- 交易金額單位為菲律賓披索(分),請乘以 100 傳入,例如收款 10000.00 請傳值 1000000
- 請求時間使用 Unix timestamp,單位為秒
- 交易結果將通知至
notify_url,請傳入可公開訪問之完整地址(僅支援 http 與 https 協議),參數規範見 交易結果通知