文档名称

文档说明：

  • 支付宝WAP支付接口文档

文档版本：

版本号 制定人 制定日期 修订日期
1.0 Eric.Yang 2019-12-07 2019-12-07

测试帐户:

联系业务经理

场景介绍:

用于手机浏览器唤起支付宝支付

案例介绍:

无

流程说明:

无

接口说明:

无

请求URL:

-https://pay.xrtpay.cn/xrtpay/gateway

请求方式：
  • POST
请求头：
参数名 是否必须 类型 说明
Content-Type 是 string 请求类型： text/xml
请求参数:
字段名 变量名 是否必须 类型 说明
接口类型 service 是 String(32) pay.alipay.wap
版本号 version 否 String(8) 默认值是 1.0
字符集 charset 否 String(8) 可选值 UTF-8，默认为 UTF-8
签名方式 sign_type 否 String(8) 取值：MD5 默认： MD5
商户订单号 out_trade_no 是 string(45) 商户订单号
商户号 mch_id 是 string(45) 商户号, 由服务商提供
设备号 device_info 否 String(32) 终端设备号
随机字符串 nonce_str 是 String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS
签名 sign 是 string(32) 签名类型，目前支持MD5，默认为MD5
商品描述 body 是 string(128) 商品简单描述，该字段须严格按照规范传递
附加信息 attach 否 String(128) 商户附加信息，可做扩展参数，255 字符内
终端 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+8 beijing。 该时间取自商户服务器
订单超时时间 time_expire 否 String(14) 订单失效时间， 格式为 yyyyMMddHHmmss，如2009 年12月27日9点 10 分 10 秒表示为20091227091010。 时区为 GMT+8 beijing。 该时间取自商户服务器
商品标记 goods_tag 否 String(32) 商品标记，微信平台配置的商品标记，用于优惠券或者满减使用
退出url quit_url 是 String(400) 用户付款中途退出返回商户网站的地址
请求参数示例:
<xml>
   <service>pay.alipay.wap</service>
   <charset>UTF-8</charset>
   <sign_type>MD5</sign_type>
   <attach>支付测试</attach>
   <body>H5支付测试</body>
   <mch_id>10000100</mch_id>
   <nonce_str>1add1a30ac87aa2db72f57a2375d8fec</nonce_str>
   <notify_url>http://wxpay.wxutil.com/pub_v2/pay/notify.v2.php</notify_url>
   <out_trade_no>1415659990</out_trade_no>
   <mch_create_ip>14.23.150.211</mch_create_ip>
   <total_fee>1</total_fee>
   <quit_url>https://pay.xrtpay.cn</quit_url>
   <sign>0CB01533B8C1EF103065174F50BCA001</sign>
</xml>

返回结果

数据按 XML 的格式实时返回

字段名 变量名 必填 类型 说明
版本号 version 是 String(8) 版本号，version 默认值是 1.0。
字符集 charset 是 String(8) 可选值 UTF-8 ，默认为 UTF-8。
签名方式 sign_type 否 String(8) 签名类型，取值：MD5 默认：MD5
返回状态码 status 是 String(16) 0 表示成功非 0 表示失败此字段是通信标识，非交易标识，交易是否成功需要查看 result_code 来判断
返回信息 message 否 String(128) 返回信息，如非空，为错误原因签名失败参数格式校验错误
以下字段在 status 为 0 的时候有返回
业务结果 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 的时候有返回
交易类型 trade_type 是 string(64) pay.alipay.wap
商户网站唯一订单号 out_trade_no 是 string(64) 商户网站唯一订单号
支付宝订单号 trade_no 是 String(64) 该交易在支付宝系统中的交易流水号。最长64位。
资金金额 total_amount 是 String (128) 该笔订单的资金总额，单位为RMB-Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。
收款支付宝账号 seller_id 是 String (128) 收款支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字
商户原始订单号 merchant_order_no 是 string(32) 商户原始订单号，最大长度限制32位
返回示例:

正确的返回:

<xml>
   <status>0</status> 
    <message><![CDATA[OK]]></message>
    <mch_id><![CDATA[10000100]]></mch_id> 
   <nonce_str><![CDATA[IITRi8Iabbblz1Jc]]></nonce_str>
   <sign><![CDATA[7921E432F65EB8ED0CE9755F0E86D72F]]></sign>
   <result_code><![CDATA[SUCCESS]]></result_code>
   <out_trade_no><![CDATA[123456]]></out_trade_no>
   <seller_id><![CDATA[20881234567890]]></seller_id>
   <seller_id><![CDATA[20881234567890]]></seller_id>
   <total_amount><![CDATA[1.00]]></total_amount>
   <trade_no><![CDATA[2019121078906789]]></trade_no>
   <merchant_order_no><![CDATA[201890898988]]></merchant_order_no>
</xml>

错误时返回:

<xml>
    <status>0</status>
    <message><![CDATA[OK]]></message>
    <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
    <mch_id><![CDATA[10000100]]></mch_id>
    <device_info><![CDATA[1000]]></device_info>
    <nonce_str><![CDATA[sthBJ9QyUG6vkrjJ]]></nonce_str>
    <sign><![CDATA[6277A96D7875D4FF23AA7B6A4C3046AB]]></sign>
    <result_code>1</result_code>
    <err_code><![CDATA[AUTHCODE_EXPIRE]]></err_code>
    <err_code_des><![CDATA[二维码已过期， 请刷新再试]]></err_code_des>
</xml>

问题排查:

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2021-03-06 11:16   作者：EricYang