日本信用卡支付接口

846字约3分钟

注意

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

账户余额查询

URL：/common/openapi/account/balance

param 参数：

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

request

{
    "param": {
        "country": "JP",
        "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, 例如: 禁止传输 123.40, 应传: 123.4)
currency	是	string	币种:USD
country	是	string	固定值：JP
merchantOrderNo	是	string	商户订单号
notifyUrl	是	string	回调地址
timestamp	是	long	交易时间戳(秒时间戳)
redirectUrl	是	string	重定向地址
remark	否	string	备注
userId	是	string	用户唯一标识(风控校验)
firstName	是	string	名, 需真实数据
lastName	是	string	姓, 需真实数据
email	是	string	邮箱, 需真实数据
address	是	string	地址, 需真实数据
city	是	string	城市, 需真实数据
state	是	string	州/省, 需真实数据
zipCode	是	string	邮编, 需真实数据
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: 系统交易完成或余额不足时会发送回调到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')