全部文档 / 【微信】APP 支付 / 原生态预下单API
原生态预下单API

业务功能

用户在商家app内选择微信支付下单成功后,商家通过平台提供的接口获取到唤起微信支付的参数信息,然后在

商家app内唤起微信支付,用户在微信内确认支付后会自动返回到用户app内。

交互模式

请求:后台请求交互模式

返回结果:后台通知交互模式

请求参数列表

请求urlhttps://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,2009122591010秒表示为20091225091010。时区为GMT+8Beijing。该时间取自商户服务器。注:订单生成时间与超时时间需要同时传入才会生效。

订单超时时间

time_expire

String(14)

订单超时时间,格式为yyyyMMddHHmmss,2009122591010秒表示为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

平台订单号