创建收款单(韩国)
创建韩圆(KRW)收款订单接口。
请求资讯
- 请求 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) | 交易结果通知地址 |
| bank_name | 否 | String(16) | 银行代码,银行列表 |
| name | 否 | String(16) | 汇款人户名 |
| last_number | 否 | String(32) | 汇款人账号 |
| request_time | 是 | Integer(10) | 请求时间(秒) |
| sign_type | 否 | String(16) | 签名类型,固定值 HMAC-SHA256 |
| sign | 是 | String(32|64) | 订单签名 |
服务 ID
SVC0026ATM支付
返回示例
成功返回
{
"error_code": "0000",
"data": {
"link": "https://pay.example.com/cashier/DEMOPM0123456",
"payment_id": "DEMOPM0123456",
"payment_cl_id": "order_20260112001",
"amount": 10000
}
}
汇款人资讯(建议传入)
bank_name / name / last_number 三项虽非必填,但建议在建单时一并传入:
- 三项齐全 → 直接返回付款连结,付款人打开即可付款
- 缺任一项 → 系统会先返回一个补填页连结,付款人须自行填写银行、户名、账号后才会取得付款连结(多一个步骤)
bank_name 请使用银行列表的银行代码。
入金方式限制
韩国银行转账通道以虚拟账户收款,付款人须依付款页显示的银行与账号完成转账。请提醒付款人:
| 项目 | 说明 |
|---|---|
| 转账方式 | 仅限网银转账;不支援 ATM 机台、TOSS、PAT App 入金 |
| 金额 | 须与订单金额完全一致,金额不符将退回 |
| 付款人 | 须由本人账户转出,第三方代转将退回 |
| 单笔上限 | 500 万韩圆 |
| 付款连结 | 一次性连结,请勿在付款人之前预先开启(包含系统自动预览、监控探活),否则付款人将无法开启该连结 |
备注
- 交易金额单位为韩圆(分),请乘以 100 传入
- 请求时间使用 Unix timestamp,单位为秒
- 交易结果将通知至
notify_url,参数规范见 交易结果通知