創建收款單（越南）
創建越南盾（VND）收款訂單接口。
請求資訊
- 請求 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) | 交易結果通知地址 |
| bank_name | 否 | String(6) | 匯款人銀行，SVC0016 時必填，銀行列表 |
| name | 否 | String(16) | 匯款人戶名 |
| request_time | 是 | Integer(10) | 請求時間（秒） |
| sign | 是 | String(32) | 訂單簽名 |
請求示例
{
"amount": "50000000",
"bank_name": "ACB",
"name": "test_name",
"notify_url": "https://xxx.xx/notification",
"payment_cl_id": "DEVPM00014581",
"platform_id": "PF0002",
"request_time": "1595504136",
"service_id": "SVC0015",
"sign": "c81634c1769044eac9e9628a2292f557"
}
返回示例
成功返回
{
"error_code": "0000",
"data": {
"link": "http://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1neP"
}
}
錯誤返回示例
{
"error_code": "0004",
"error_msg": "验签错误!"
}
返回參數說明
| 參數名 | 類型 | 說明 |
|---|---|---|
| error_code | String | 錯誤碼 |
| error_msg | String | 錯誤訊息（error_code 不為 "0000" 時返回） |
| link | String | 訂單收銀地址 |
| amount | Int | 提單金額 |
備註
- 商戶 ID 為系統分配之唯一識別，如尚未取得請聯繫系統人員
- 服務 ID 請填入：
SVC0015銀行卡（指定銀行越南通道）SVC0016網關直連（指定銀行越南通道）SVC0017QR 掃碼（不指定銀行越南通道）SVC0018MOMO PAY（越南通道）SVC0019VIETTEL PAY（越南通道）SVC0047ZALO（越南通道）SVC0072MOMO 原生（越南通道）- 參考 service_id 列表
- 交易金額單位為越南盾（分），請乘以 100 傳入，例如收款 10000.00 請傳值 1000000
- 請求時間使用 Unix timestamp，單位為秒
- 交易結果將通知至
notify_url，請傳入可公開訪問之完整地址（僅支援 http 與 https 協議），參數規範見 交易結果通知