跳到主要内容

创建收款单(韩国)

创建韩圆(KRW)收款订单接口。

请求资讯

  • 请求 URL: /gateway/api/v2/payments
  • 请求方式: POST
  • Content-Type: application/json;charset=utf-8

请求参数

参数名必选类型说明
platform_idString(6)商户 ID
service_idString(7)服务 ID
payment_cl_idString(64)商户订单号
amountInteger(10)金额(分)
notify_urlString(256)交易结果通知地址
bank_nameString(16)银行代码,银行列表
nameString(16)汇款人户名
last_numberString(32)汇款人账号
request_timeInteger(10)请求时间(秒)
sign_typeString(16)签名类型,固定值 HMAC-SHA256
signString(32|64)订单签名

服务 ID

  • SVC0026 ATM支付

返回示例

成功返回

{
"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,参数规范见 交易结果通知