接口链接
测试URL地址:
生产URL地址:
请求参数
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
商户ID | mchId | 是 | String(30) | 1000000010 | 支付中心分配的商户号 |
支付订单号 | payOrderId | 是 | String(30) | P20160427210604000490 | 支付中心生成的订单号,与mchOrderNo二者传一即可 |
商户订单号 | mchOrderNo | 是 | String(30) | 20160427210604000490 | 商户生成的订单号,与payOrderId二者传一即可 |
是否执行回调 | executeNotify | 否 | Boolean | true | 是否执行回调,如果为true,则支付中心会再次向商户发起一次回调,如果为false则部发起 |
签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值,详见签名算法 |
返回结果
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
返回状态码 | retCode | 是 | String(16) | SUCCESS | SUCCESS/FAIL此字段是通信标识,非交易标识,交易是否成功需要查看resCode来判断 |
返回信息 | retMsg | 否 | String(128) | 签名失败 | 返回信息,如非空,为错误原因 签名失败 参数格式校验错误 |
以下字段在retCode为SUCCESS的时候有返回
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
业务结果 | resCode | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
错误代码 | errCode | 否 | String(32) | SYSTEMERROR | 错误码 |
错误代码描述 | errCodeDes | 否 | String(128) | 系统错误 | 结果信息描述 |
以下字段在retCode和resCode都为SUCCESS的时候有返回
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
商户ID | mchId | 是 | String(30) | 20001222 | 支付中心分配的商户号 |
商户订单号 | mchOrderNo | 是 | String(30) | 20160427210604000490 | 商户生成的订单号 |
渠道ID | channelId | 是 | String(24) | WX_JSAPI | 见支付渠道参数 |
币种 | currency | 是 | String(3) | cny | 三位货币代码,人民币:cny |
支付金额 | amount | 是 | int | 100 | 支付金额,单位分 |
客户端IP | clientIp | 否 | String(32) | 210.73.10.148 | 客户端IP地址 |
设备 | device | 否 | String(64) | ios10.3.1 | 客户端设备 |
支付结果回调URL | notifyUrl | 是 | String(200) | http://shop.xxpay.org/notify.htm | 支付结果回调URL |
商品主题 | subject | 是 | String(64) | xxpay测试商品1 | 商品主题 |
商品描述信息 | body | 是 | String(256) | xxpay测试商品描述 | 商品描述信息 |
扩展参数1 | param1 | 否 | String(64) | 支付中心回调时会原样返回 | |
扩展参数2 | param2 | 否 | String(64) | 支付中心回调时会原样返回 | |
附加参数 | extra | 是 | String(512) | {“openId”:”o2RvowBf7sOVJf8kJksUEMceaDqo”} | 特定渠道发起时额外参数,见下面说明 |
支付成功时间 | paySuccTime | 否 | Long | 1505049094262 | 支付成功时间 |
渠道订单号 | channelOrderNo | 否 | String | wx20170910211043fb206e92260071822007 | 对应的第三方支付订单号 |