俄罗斯支付接口

1425字约5分钟

注意

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

限额

交易类型	限额(单位:RUB)
代收	QIWI : 5 ~ 60000 BANK_CARD : 1 ~ 350000 YOOMONEY : 1 ~ 250000 SBER_PAY : 1 ~ 500000
代付	QIWI: 5-600000 BANK_CARD: 5-600000

账户余额查询

URL：/common/openapi/account/balance

param 参数：

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

request

{
    "param": {
        "country": "VNM",
        "currency": "VND",
    },
    "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	BigDecimal	总金额
freeAmount	BigDecimal	可用金额
unrecordedAmount	BigDecimal	在途金额
freezeAmount	BigDecimal	冻结金额
sign	string	签名

代付接口

代付下单

URL：/russia/openapi/payOut

param参数：

参数名	必选	类型	说明
account	是	string	账号(BANK_CARD：银行卡号；YOOMONEY：钱包编号；QIWI：QIWI钱包绑定的真实手机号)
accountName	是	string	收款人姓名
amount	是	number	交易金额 (小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
payMode	是	string	支付类型(bank/ewallet)
channelCode	是	string	支付渠道,银行编码/钱包编码(BANK_CARD/YOOMONEY)
currency	是	string	币种:RUB
merchantOrderNo	是	string	商户订单号
notifyUrl	是	string	回调地址
timestamp	是	long	交易时间戳(秒时间戳)
phone	是	string	真实手机号
lastName	是	string	姓，BANK_CARD时必传
firstName	是	string	名，BANK_CARD时必传
middleName	是	string	中间名，BANK_CARD时必传
docNumber	是	string	护照号码，BANK_CARD时必传
docIssueDate	是	string	护照签发日期yyyyMMdd，BANK_CARD时必传
birthDate	是	string	生日yyyyMMddBANK_CARD时必传
city	是	string	城市，BANK_CARD且金额大于15000RUB时必传
address	是	string	住址，BANK_CARD且金额大于15000RUB时必传
postcode	是	string	邮编，BANK_CARD且金额大于15000RUB时必传
remark	否	string	备注

request

{
	"param": {
		"account": "test",
		"accountName": "test",
		"amount": 100000,
		"bankCode": "VB",
              "currency": "RUB",
		"channelCode": "bank",
		"merchantOrderNo": "5825683320230508569",
		"notifyUrl": "https://www.",
		"timestamp": 1684591961,
               "phone": "123456789",
               "remark": "remark"
	},
	"sign": "111"
}

response

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

返回data参数说明

参数名	类型	说明
merchantNo	string	平台商户号
plaOrderNo	string	平台订单号
sign	string	签名
status	string	交易状态('PENDING','COMPLETED','FAILED')

代收接口

支付视频

收款

URL：/russia/openapi/payIn

param参数：

参数名	必选	类型	说明
amount	否	string	订单金额 (小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
channelCode	是	number	支付渠道（BANK_CARD\YOOMONEY\SBER_PAY）
clientIp	否	string	付款人IP地址
currency	否	string	币种(RUB)
merchantOrderNo	是	string	商户订单号
notifyUrl	否	string	回调地址
payMode	是	string	支付类型(固定为bank)
phone	是	string	真实手机号码(qiwi钱包支付时，该值必传)
redirectUrl	是	string	重定向地址
remark	是	integer	备注
timestamp	是	string	交易时间戳

request

{
  "param": {
    "amount": 0,
    "channelCode": "",
    "clientIp": "",
    "currency": "",
    "merchantOrderNo": "",
    "notifyUrl": "",
    "payMode": "",
    "phone": "",
    "redirectUrl": "",
    "remark": "",
    "timestamp": 0
  },
  "sign": ""
}

response

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

返回data参数说明

参数名	类型	说明
fee	number	手续费
merchantOrderNo	string	商户订单号
payData	string	支付信息
payUrl	string	XwinPay提供的二维码支付页面
plaOrderNo	long	平台订单号
sign	string	验签
status	string	支付状态

收款-收银台

URL：/russia/openapi/payInH5

param参数：

与收款相比，减少字段：payMode，channelCode

参数名	必选	类型	说明
amount	否	string	订单金额 (小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
channelCode	是	number	支付渠道（BANK_CARD\YOOMONEY\SBER_PAY）
clientIp	否	string	付款人IP地址
currency	否	string	币种(RUB)
merchantOrderNo	是	string	商户订单号
notifyUrl	否	string	回调地址
payMode	是	string	支付类型(固定为bank)
phone	是	string	真实手机号码(qiwi钱包支付时，该值必传)
redirectUrl	是	string	重定向地址
remark	是	integer	备注
timestamp	是	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	支付状态('PENDING','COMPLETED','FAILED')
errorCode	string	错误编码(status为FAILED时有值)
errorMessage	string	错误信息(status为FAILED时有值)
sign	string	签名使用平台公钥验签(取reqeust body里的数据，)

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：/russia/openapi/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')