业务功能
提交相应的信息获取唯一的云闪付用户信息。
交互模式
后台系统调用交互模式
请求 url：https://pay.xrtpay.c/xrtpay/gateway
请求方式
POST
请求参数列表
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 接口类型 |
service |
是 |
String(32) |
unpay.trade.userid |
| 版本号 |
version |
否 |
String(8) |
默认值是2.0。 |
| 字符集 |
charset |
否 |
String(8) |
默认为 UTF-8。 |
| 签名方式 |
sign_type |
否 |
String(8) |
取值：MD5 默认：MD5 |
| 商户号 |
mch_id |
是 |
String(32) |
商户号， 由技术人员分配 |
| 银联授权码 |
user_auth_code |
是 |
String(64) |
银联授权码 |
| 银联支付标识 |
app_up_identifier |
是 |
String(32) |
银联支付标识收款方识别HTTP请求User Agent中包含银联支付标识,格式为“UnionPay/<版本号> <App标识>”,注意APP标识仅支持字母和数字。例云闪付APP为: UnionPay/1.0 CloudPay |
| 随机字符串 |
nonce_str |
是 |
String(32) |
随机字符串， 不长于 32 位 |
| 签名 |
sign |
是 |
String(32) |
MD5 签名结果，详见“数字签名 MD5 签名规则” |
返回结果
数据按 XML 的格式实时返回
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 版本号 |
version |
是 |
String(8) |
默认值是 2.0。 |
| 字符集 |
charset |
是 |
String(8) |
默认为 UTF-8。 |
| 签名方式 |
sign_type |
否 |
String(8) |
取值： MD5 默认： MD5 |
| 返回状态码 |
status |
是 |
String(16) |
0 表示成功非 0 表示失败此字段是通信标识， 非交易标识， 交易是否成功需要查看 trade_state 来判断 |
| 返回信息 |
message |
否 |
String(128) |
返回信息， 如非空，为错误原因签名失败参数格式校验错误 |
| 业务结果 |
result_code |
是 |
String(16) |
0 表示成功非 0 表示失败 |
| 商户号 |
mch_id |
是 |
String(32) |
商户号， 由技术部分配 |
| 设备号 |
device_info |
否 |
String(32) |
终端设备号 |
| 随机字符串 |
nonce_str |
是 |
String(32) |
随机字符串， 不长于 32 位 |
| 错误代码 |
err_code |
否 |
String(32) |
具体错误码请看文档最后错误码列表 |
| 错误代码描述 |
err_msg |
否 |
String (128) |
结果信息描述 |
| 签名 |
sign |
是 |
String(32) |
MD5 签名结果， 详见“数字签名 MD5 签名规则” |
| 以下字段在 status 和 result_code 都为 0 的时候有返回 |
| 银联用户ID |
user_id |
是 |
String(128) |
银联userId |
文档更新时间: 2021-11-20 10:53 作者：EricYang
