注意

阅读该接口文档前，务必先查看 接口说明

限额

交易类型	限额
代收	美元：0.99-499.99；韩元：1500~1000000

代收API

代收申请

简要描述：

• 创建代收订单

URL：

韩元: /krw/collect/apply

美元: /usd/collect/apply

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取）
orderId	是	String	商户订单号(必须保证唯一性)
name	是	String	用户姓名
phone	是	String	手机号（格式参考 电话号码格式 ）
email	是	String	电子邮件
amount	是	String	交易金额（精确到小数点后两位；禁止添加标点符号，例如：”,”） 范围参考：收款编码Code
payType	是	String	非收银台模式：BANK_TRANSFER 收银台模式：CASHIER
inBankCode	是	String	收款编码
callBackUrl	是	String	支付完成后跳转地址
subject	否	String	支付备注
country	否	String	收银台模式需要传递，请传：410
body	否	String	备注详情
sign	是	String	签名

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号(必须保证唯一性)
orderNo	String	平台订单号
payUrl	String	支付链接
sign	String	签名

代收查询

简要描述：

• 查询代收订单

URL：

韩元: /krw/collect/query

美元: /usd/collect/query

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取）
orderId	是	String	商户订单号
orderNo	否	String	平台订单号（响应快）
sign	是	String	签名

request

{
    "appId": 1054,
    "orderId": "M22222000028",
    "sign": "EmyJGm3ELzG4FsOd0Krs9ncbSjo4oTGuXWML+7djYla3+VAwd9wS17z38p/7U2ZAjroO04XrE7YXcB1o76Dtyipj3h3bJzs7FYma1QNkMUdt9hh7m8U6hMsMQX7vIWHtXNwz4pbTSC75+kQWXaCew7KoE6LXECdJU8AISgNgeki2TK9R0pCfshr0Z2SZBPeuT6OvIH5LdmqgdZhuqnffGU2qnXk4KMkO848e6/WALLBR+LE1wyKHfPnYVcuKSMVYxkvKyyIL5JIPEgW0o5bh4RCbaUn3NZtyYwrU1uQ3ZDFRThm9j6XAQP+LBlmq3nOePqBtp/VDVarRaV+7FbQg3A=="
}

response

{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M22222000028",
        "orderNo": "6023042811314347",
        "amount": "50.00",
        "actualAmount": "0.00",
        "fee": "0.00",
        "status": 1,
        "sign": "fP433ygWVDLVGxYkVnIJj7riGq0U3vyVX+MbBAImxfGLZkZcEAHVEoVYuULZSmXAAXKRSyd67WlDNm+24pougM54ofAoH4HMtCL2tfCoBReFyz3z02AGKkrKE2xWhSpWoqfQoBvzwuN5iGMMu0s9Q1YvqiwJ8WDVIENnmiIyD8qDJN7caHTW2US14/faG+69AvnuIgJ/nu7/jogOlgEYdZdVYU7gcRDE+d47KjlFGswQkJ/h/uzV7cWtUqrtOO7ZnZ3/z33Xx8awokX36QoYcPSWAU0h+Ij9O9402HNhm1eTbYcLU0uI/z8xCAtyAI/tTyiFijpiNlxUKQj+zKsILw=="
    }
}

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号(必须保证唯一性)
orderNo	String	平台订单号
amount	String	交易金额
actualAmount	String	收到金额
fee	String	手续费
status	Integer	状态(0未开始，1支付中，2成功（终态），3失败（终态）, -1异常待确认)
payTime	String	支付成功时间（当status=2时有值）(本地时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsg	String	支付失败原因（当status=3时有值）
sign	String	签名

收款编码

1.收银台模式：

payType	inBankCode
CASHIER	CASHIER

2.非收银台模式：

payType	inBankCode	限额	说明	本地收银台
BANK_TRANSFER	KAKAOPAY_USD	0.99-1000	美元下单，韩国kakao	支持
BANK_TRANSFER	TOSS_USD	0.99-1000	美元下单，韩国toss	支持
BANK_TRANSFER	NAVERPAY_USD	0.99-1000	美元下单，韩国naverpay	支持
BANK_TRANSFER	KAKAOPAY_KRW	1500~1000000	韩元下单，韩国kakao	支持
BANK_TRANSFER	TOSS_KRW	1500~1000000	韩元下单，韩国toss	支持
BANK_TRANSFER	NAVERPAY_KRW	1500~1000000	韩元下单，韩国naverpay	支持

privateKey

secreteKey

url

Request Sample: