创建收款单（越南）
创建越南盾（VND）收款订单接口。
请求资讯
- 请求 URL：
/gateway/api/v2/payments - 请求方式：
POST - Content-Type：
application/json;charset=utf-8
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| platform_id | 是 | String(6) | 商户 ID |
| service_id | 是 | String(7) | 服务 ID |
| payment_cl_id | 是 | String(64) | 商户订单号 |
| amount | 是 | Integer(10) | 金额（分） |
| notify_url | 是 | String(256) | 交易结果通知地址 |
| request_time | 是 | Integer(10) | 请求时间（秒） |
| sign_type | 否 | String(16) | 签名类型：HMAC-SHA256（推荐）或 MD5（默认） |
| sign | 是 | String(32 | 64) |
请求示例
{
"amount": "50000000",
"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": "https://pay.example.com/cashier/DEMOPM0123456",
"payment_id": "DEMOPM0123456",
"payment_cl_id": "order_20260112001",
"amount": 5001000,
"qr_code_content": "00020101021238600010A000000727013000069704480",
"token": "fabdzannfa",
"card_name": "NGUYEN VAN A",
"card_number": "0110100007725008",
"bank_name": "Asia Commercial Bank"
}
}
错误返回示例
{
"error_code": "0004",
"error_msg": "验签错误!"
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误讯息（error_code 不为 "0000" 时返回） |
| link | String | 订单收银台地址 |
| payment_id | String | Diamond Pay 订单号 |
| payment_cl_id | String | 商户订单号 |
| amount | Int | 提单金额 |
| token | String | 转帐附言 |
| qr_code_content | String | qr code 内容 |
| card_name | String | 收款人姓名 |
| card_number | String | 银行卡号 |
| bank_name | String | 银行名称 |
备注
- 商户 ID 为系统分配之唯一识别，如尚未取得请联系系统人员
- 服务 ID 请填入：
SVC0015银行卡（越南通道）SVC0016银行直连（越南通道）SVC0017QR 扫码（越南通道）- 参考 service_id 列表
- 交易金额单位为越南盾（分），请乘以 100 传入，例如收款 10000.00 请传值 1000000
- 请求时间使用 Unix timestamp，单位为秒
- 交易结果将通知至
notify_url，请传入可公开访问之完整地址（仅支援 http 与 https 协议），参数规范见 交易结果通知