业务功能
用户在商家app内选择微信支付下单成功后,商家通过平台提供的接口获取到唤起微信支付的参数信息,然后在
商家app内唤起微信支付,用户在微信内确认支付后会自动返回到用户app内。
交互模式
请求:后台请求交互模式
返回结果:后台通知交互模式
请求参数列表
请求url:https://qra.95516.com/pay/gateway
POST XML 内容体进行请求
字段名 | 变量名 | 必填 | 类型 | 说明 |
接口类型 | service | 是 | String(32) | 接口类型:pay.weixin.raw.app |
版本号 | version | 否 | String(8) | 版本号,version默认值是2.0。 |
字符集 | charset | 否 | String(8) | 可选值 UTF-8 ,默认为 UTF-8。 |
签名方式 | sign_type | 否 | String(8) | 签名类型,取值范围: MD5(默认); SM3; |
商户号 | mch_id | 是 | String(15) | 商户号,由平台分配 |
appid | appid | 是 | String(32) | 商户app对应的微信开放平台移动应用APPID |
商户订单号 | out_trade_no | 是 | String(32) | 商户系统内部的订单号,32个字符内、可包含字母,确保在商户系统唯一 |
设备号 | device_info | 否 | String(32) | 终端设备号 |
收银员 | op_user_id | 否 | String(32) | 操作员帐号,默认为商户号 |
门店编号 | op_shop_id | 否 | String(32) | |
商品描述 | body | 是 | String(127) | 商品描述 |
附加信息 | attach | 否 | String(127) | 商品附加信息,可做扩展参数 |
总金额 | total_fee | 是 | Int | 总金额,以分为单位,不允许包含任何字、符号 |
终端IP | mch_create_ip | 是 | String(16) | 订单生成的机器IP |
通知地址 | notify_url | 是 | String(255) | 接收平台通知的URL,需给绝对路径,255字符内格式,确保平台能通过互联网访问该地址 |
订单生成时间 | time_start | 否 | String(14) | 订单生成时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010。时区为GMT+8Beijing。该时间取自商户服务器。注:订单生成时间与超时时间需要同时传入才会生效。 |
订单超时时间 | time_expire | 否 | String(14) | 订单超时时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010。时区为GMT+8Beijing。该时间取自商户服务器。注:订单生成时间与超时时间需要同时传入才会生效。 |
限制信用卡 | limit_credit_pay | 否 | String(1) | 限定用户使用时能否使用信用卡,值为1,禁用信用卡,值为0或者不传此参数则不禁用 |
商品标记 | goods_tag | 否 | String(32) | 商品标记 |
终端信息 | terminal_info | 否 | String | 商户侧受理终端信息,字段详 细说明参考统一被扫其他扩展字段说明。 |
随机字符串 | nonce_str | 是 | String(32) | 随机字符串,不长于 32 位 |
商户APP应用ID | sub_appid | 是 | String(32) | 微信开放平台审核通过的移动应用AppID |
签名 | sign | 是 | String(32) | MD5签名结果,详见“安全规范” |
授权交易机构 | sign_agentno | 否 | String(12) | 授权交易的服务商机构代码,商户授权给服务商交易的情况下必填,签名使用服务商的密钥 |
连锁商户号 | groupno | 否 | String(15) | 连锁商户为其下门店发交易的情况必填,签名使用连锁商户的密钥 |
返回结果
数据按XML格式实时返回
字段名 | 变量名 | 必填 | 类型 | 说明 |
版本号 | version | 是 | String(32) | 版本号,version默认值是2.0。 |
字符集 | charset | 是 | String(8) | 可选值 UTF-8 ,默认为 UTF-8 |
授权交易机构 | sign_agentno | 否 | String(12) | 授权交易的服务商机构代码,商户授权给服务商交易的情况下必填,签名使用服务商的密钥 |
连锁商户号 | groupno | 否 | String(15) | 连锁商户为其下门店发交易的情况必填,签名使用连锁商户的密钥 |
签名方式 | sign_type | 否 | String(8) | 签名类型,取值范围: MD5(默认); SM3; |
返回状态码 | status | 是 | String(8) | 0表示交易成功,非0表示失败,此字段是通信标识,非交易标识,交易是否成功需要看你result_code来判断 |
返回信息 | message | 否 | String(32) | 返回信息,如非空,为错误原因签名失败参数格式校验错误 |
网关返回码 | code | 否 | String(32) | 网关返回码 |
以下字段在 status 为 0的时候有返回 | ||||
业务结果 | result_code | 是 | String(16) | 0表示成功,非0表示失败 |
商户号 | mch_id | 是 | String(15) | 商户号,由平台分配 |
设备号 | device_info | 否 | String(32) | 平台支付分配的终端设备号 |
随机字符串 | nonce_str | 是 | String(32) | 随机字符串,不长于 32 位 |
错误代码 | err_code | 否 | String(32) | 具体错误码请看错误码列表 |
错误代码描述 | err_msg | 否 | String(128) | 结果信息描述 |
签名 | sign | 是 | String(32) | MD5签名结果,详见“安全规范” |
以下字段在 status 和result_code 都为 0的时候有返回 | ||||
支付信息 | pay_info | 是 | String | Json格式的字符串,微信官方SDK中需要的参数信息 |
商户订单号 | out_trade_no | 是 | String | 商户订单号 |
平台订单号 | transaction_id | 是 | String | 平台订单号 |