欧美日韩支付接口

1492字约5分钟

注意

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

限额

交易类型	限额(单位:USD)
代收	0.99-499.99

账户余额查询

URL：/common/openapi/account/balance

param 参数：

参数名	必选	固定值	说明
country	是	UN	国家编码
currency	是	USD	币种

request

{
    "param": {
        "country": "UN",
        "currency": "USD",
    },
    "sign": "Gw6D0kuWlnngLMiSxQQ2Dz2ciZz4LUZ7gWA8dRkEbcsE+UoiTOy6T3g6vNvGUlz+vPV2aRHKZ6aPBh0PaJkWW36T/lf8qId4D9uh8lFeTe7zW0+hTgTnN9YmruA6rlRNCo9QytbMRk6qkEZh1PZ2NrFnC77FhYVEVdOk6bIOv/vnGo1RVpbmsO+Gw+tPnvkQ1jvVDEHUlKgnAFGYa7+oWw8eClh9T4Ob7ZUPI0Z+dhefAmEX+z8DCyUxZrtbgA0li21KW2TmErIiRJQxep/f4quWRoTKkPziiMefKo1jFgbyL/gVzgkp91YaMMyk1QJKW1UoZ8iqHKNMI6pmvBCk8g=="

}

response

{
    "code": 200,
    "message": "",
    "data": {
        "merId": "",
        "merName": "",
        "currency": "",
        "amountTotal": "0.00",
        "freeAmount": "1085178690.00",
        "unrecordedAmount": "0.00",
        "freezeAmount": "1085178690.00",
        "frzBal": "0.00",
        "sign": "签名"
    }
}

返回data参数说明

参数名	类型	说明
merId	string	商户号
merName	string	商户名称
currency	string	币种
amountTotal	string	总金额
freeAmount	string	可用金额
unrecordedAmount	string	在途金额
freezeAmount	string	冻结金额
sign	string	签名

代收接口

代收下单

URL：/credit/card/payIn

请求参数：

参数名	必选	类型	说明
amount	是	number	交易金额（0.99~499.99） (小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
currency	是	string	币种:USD/EUR/KRW，需根据参数country来判断
country	是	string	1. 信用卡收款：美国：UN，支持币种USD 2. 本地钱包收单：中国台湾：TW，支持币种USD 韩国：KR，支持币种USD（支付页面显示KRW） ~~韩国 Kakao Pay：KR，支持币种KRW~~ 韩国 Toss Pay：TOSS，支持币种KRW 韩国 Naver Pay：NAVERPAY，支持币种KRW 荷兰 IDEAL：NLD_IDEAL，支持币种USD/EUR 波兰 BLIK：POL_BLIK，支持币种USD（支付页面显示PLN）波兰 PAYU：POL_PAYU，支持币种USD（支付页面显示PLN）波兰 PRZELEWY24：POL_PRZELEWY24，支持币种USD（支付页面显示PLN） ~~德国 GIROPAY：DEU_GIROPAY，支持币种USD/EUR~~ 德国 SOFORT：DEU_SOFORT（未开通）奥地利 EPS：AUT_EPS，支持币种USD/EUR 比利时 BANCONTACT：BEL_BANCONTACT，支持币种USD/EUR 意大利 BANCOMAT PAY：ITA_BANCOMATPAY（未开通）
merchantOrderNo	是	string	商户订单号
notifyUrl	是	string	回调地址
timestamp	是	long	交易时间戳(秒时间戳)
redirectUrl	是	string	重定向地址
remark	否	string	备注
userId	是	string	用户唯一ID(风控校验) , 非时间戳等无效数据, 需真实数据
sign	是	string	签名

request

{
    "amount": 0,
    "currency": "USD",
    "currency": "UN",
    "merchantOrderNo": "",
    "notifyUrl": "",
    "redirectUrl": "",
    "remark": "",
    "timestamp": 0,
    "sign": ""
}

response

{
	"code": 0,
	"data": {
		"fee": 0,
		"merchantOrderNo": "",
		"payData": "",
		"payUrl": "",
		"plaOrderNo": "",
		"sign": "",
		"status": "",
		"timestamp": 0
	},
	"message": ""
}

返回data参数说明

参数名	类型	说明
fee	BigDeciaml	手续费
merchantOrderNo	string	商户订单号
payData	string	支付信息
payUrl	string	支付url
plaOrderNo	string	平台订单号
sign	string	签名
status	string	支付状态
timestamp	string	交易时间戳

代收下单-韩国钱包收银台

URL：/credit/card/payInH5/kr

请求参数：（与代收下单相比，减少字段：country）

整合NaverPay、Toss Pay、~~Kakao Pay~~三种方式

参数名	必选	类型	说明
amount	是	number	交易金额(小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
currency	是	string	币种:KRW
merchantOrderNo	是	string	商户订单号
notifyUrl	是	string	回调地址
timestamp	是	long	交易时间戳(秒时间戳)
redirectUrl	是	string	重定向地址
remark	否	string	备注
userId	是	string	用户唯一ID(风控校验) , 非时间戳等无效数据, 需真实数据
sign	是	string	签名

响应参数：

参数名	必选	类型	说明
merchantNo	是	string	平台商户号
merchantOrderNo	是	string	商户订单号
plaOrderNo	是	string	平台订单号
amount	是	string	交易金额
status	是	string	交易状态
payUrl	是	string	支付链接

代收下单-欧洲钱包收银台

URL：/credit/card/payInH5/ue

请求参数：

参数名	必选	类型	说明
amount	是	number	交易金额(小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
currency	是	string	币种:USD/EUR
type	是	string	展示此国家的钱包支持编码如下：传三位数字即可 All：000，展示所有支持的钱包 ~~Germany：276，展示德国支持的钱包~~ Belgium： 056，展示比利时支持的钱包 Netherlands： 528，展示荷兰支持的钱包 Poland：616，展示波兰支持的钱包 Austria：040，展示奥地利支持的钱包
merchantOrderNo	是	string	商户订单号
notifyUrl	是	string	回调地址
timestamp	是	long	交易时间戳(秒时间戳)
redirectUrl	是	string	重定向地址
remark	否	string	备注
userId	是	string	用户唯一ID(风控校验) , 非时间戳等无效数据, 需真实数据
sign	是	string	签名

响应参数：

参数名	必选	类型	说明
merchantNo	是	string	平台商户号
merchantOrderNo	是	string	商户订单号
plaOrderNo	是	string	平台订单号
amount	是	string	交易金额
status	是	string	交易状态
payUrl	是	string	支付链接

订单回调通知

URL: 系统交易完成或余额不足时会发送回调到notify_url回调通知地址

响应: 接受请求后请返回“success”字符串给我们

请求方式：

method: POST
Content Type: application/json

body参数：

参数名	类型	说明
amount	string	订单金额
fee	string	手续费
merchantNo	string	平台商户号
merchantOrderNo	string	商户订单号
merchantPayTime	string	商户交易时间
plaOrderNo	long	平台订单号
plaStatusTime	string	平台订单状态流转时间
status	string	支付状态('COMPLETED','FAILED')
errorCode	string	错误编码(status为FAILED时有值)
errorMessage	string	错误信息(status为FAILED时有值)
sign	string	签名使用平台公钥验签(取reqeust body里的数据，)
product	string	支付产品信息（非必有）

request

{
	"merchantNo": "58256833",
	"merchantOrderNo": "5825683320230508569",
	"plaOrderNo": "1223050839733260230",
	"status": "COMPLETED",
	"amount": "100000",
	"merchantPayTime": "2023-05-08 11:14:01",
	"plaStatusTime": "2023-05-08 11:14:30",
	"fee": "200",
	"sign": "bXE1dI7TrjmRvIGrcfgBqMKhSCsTAtvtoZBd4GIl6NQOqd/8qGudTmX3WJn37NX+v8ehaSGUNSa+4ocAzWQlNQMqJ/OH2Hd+mViXjR2+6n3q4WsvHTzoDGR0VT85jT2cjR421RnnzaC/eLy/02Zx/j7y2snodVnzi6L3RfiY2gM="
}

交易状态查询

URL：/credit/card/orderStatus

param参数：

参数名	必选	类型	说明
plaOrderNo	是	Long	平台订单号

request

{
	"param": {
		"plaOrderNo": 1223050839733260230
	},
	"sign": "111"
}

response — 订单成功

{
	"code": 200,
	"message": "操作成功",
	"data": {
		"merchantNo": "34430939",
		"merchantOrderNo": "3443093920230506547",
		"plaOrderNo": "1123050691235966790",
		"channelCode": "boost",
		"status": "FAILED",
		"amount": "1",
		"merchantPayTime": "2023-05-06 18:13:36",
		"plaStatusTime": "2023-05-06 18:14:10"
	}
}

返回data参数说明

参数名	类型	说明
amount	string	订单金额
channelCode	string	支付渠道
merchantNo	string	平台商户号
merchantOrderNo	string	商户订单号
merchantPayTime	string	商户交易时间
plaOrderNo	string	平台订单号
plaStatusTime	string	平台订单状态流转时间
status	string	支付状态('PENDING','COMPLETED','FAILED')