赛捷软件论坛's Archiver

vicky.yu 发表于 2025-12-1 10:00

微信小程序 扫码支付

扫码支付
(1)支付回调接口
业务方调用微信扣费接口之后,接收扣费结果通知。

1、 请求参数
参数名称        类型        必选        备注
appid        string        Y        小程序
appidmch_id        string        Y        支付商户号
nonce_str        string        Y        随机字符串
encrypted_data        string        Y        使用AESCBCPKCS7PADDING
iv        string        Y        用于解密的IV
sign        string        Y        1~5字段的签名
解密后的参数如下:

参数名称        类型        必选        备注
openid        string        Y        用户在小程序appid下的openid
bank_type        string        Y        支付类型
total_fee        int        Y        支付总额,单位为分
trade_state        string        Y        支付状态:SUCCESS/FAIL
trade_msg        string        N        支付失败时返回
transaction_id        string        Y        微信支付单号
out_trade_no        string        Y        乘车码业务方单号
attach        string        N        扣费API的入参,原样带回
time_end        string        Y        支付完成时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010
qrcode        string        Y        二维码
2、 返回参数
参数名称        类型        必选        备注
errcode        int        Y        0为成功
errmsg        string        N        错误信息
nonce_str        string        Y        原样带回
3、 示例代码
{"appid":"test","mch_id":"123456","nonce_str":"abcdefg","encrypted_data":"jfiwajeofjiefef","iv":"afweifwefe"}
解密后数据:

{"openid":"fafwefawef","bank_type":"CFT","total_fee":100,"trade_state":"SUCCESS",...}
(2)微信扣费接口(微信API接口)
用于接收业务方依据扫码接口获取到的信息对用户进行免密扣费。

1、请求参数
参数名称        类型        必选        备注
qrcode        string        Y        乘车码数据,需要base64
total_fee        int        Y        支付总额,分为单位(优惠后)
original_fee        int        Y        支付总额,分为单位(优惠前)
machine_ip        string        N        扫码机接入IP
machine_latitude        float        N        扫码机GPS纬度
machine_longitude        float        N        扫码机GPS经度
body        string        Y        公交代扣/地铁代扣
start_time        string        Y        上车/乘车时间,如20091225091010
end_time        string        N        下车时间,格式同上,适用于二次刷码的场景
line_name        string        Y        乘车线路
trade_scene        string        Y        METRO/BUS
start_qrcode        string        N        二次刷码时,传入首次刷码使用的二维码
out_order_no        string        N        业务方自定义订单号,需要保证唯一
attach        string        N        业务方自定义数据,对账单和查询接口会原样返回
2、 返回参数
参数名称        类型        必选        备注
errcode        int        32Y        返回码
errmsg        string        N        返回信息
3、 示例代码
入参:

{"qrcode":"afefawefwef",....}
返回

{"errcode":0,....}

页: [1]

Powered by Discuz! Archiver 7.2  © 2001-2009 Comsenz Inc.