4.2云微支付


生产地址:https://vsp.allinpay.com/apiweb/ywpay/pay

测试地址:https://syb-test.allinpay.com/apiweb/ywpay/pay

使用场景:

商户调用此接口发起云闪付微信小程序支付下单,下单成功返回拉起云闪付微信小程序收银台的小程序appid和收银台路径,商户小程序根据规范拉起微信小程序。

请求参数:

参数 参数名称 取值 可空 长度 备注
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 接口版本号 2 默认填12
randomstr

随机

字符串

商户自行生成的随机字符串 32  
trxamt 交易金额 单位为分 15  
reqsn

商户

交易单号

商户的交易订单号 32 保证商户平台唯一
body 订单标题

订单商品名称

为空则以商户名作为商品名称

100 最大100个字节(50个中文字符)
remark 备注 备注信息 300  
expiretime

订单超时

时间

yyyyMMddHHmmss 2 最晚24小时
appname 应用名称 填小程序ID/公众号ID 100

通过wx.navigateToMiniProgram

(小程序接口)

或wx-open-launch-weapp

(公众号开放标签)

拉起云闪付小程序

limit_pay 支付限制

no_credit--

指定不能使用信用卡支付

32  
notify_url

交易结果

通知地址

接收异步通知回调地址

通知url必须为直接可访问的url

不能携带参数。

256  
apptype

交易发起

场景

03:小程序

04:公众号

2  
cusip 终端ip 用户下单和调起支付的终端ip地址 16 客户端的用户ip,不能为空
asinfo 分账信息

格式:

cusid:type:amount;cusid:type:amount

其中

cusid:接收分账的通联商户号

type分账类型

01:按金额  02:按比率)

如果分账类型为02,

则分账比率为0.5表示50%。

如果分账类型为01,

则分账金额以元为单位表示

1024 开通此业务需开通分账配置
signtype 签名方式   8

RSA

SM2

sign 签名 详见安全规范 32  
idno 证件号   32 需SM4加密
truename 付款人真实姓名   32 需SM4加密
encrypttype    

敏感信息

加密方式

暂只支持SM4

对接参数需配置SM4密钥

4 默认SM4
extendparams 拓展参数

json字符串

注意是String

一般用于渠道的活动参数填写 

- 参考拓展参数附录说明 

响应参数:

字段ID 字段名称 取值 可空 最大长度 备注
retcode 返回码 SUCCESS/FAIL 8

此字段是通信标识

非交易结果

交易是否成功需要查看trxstatus来判断

retmsg 返回码说明   100  
以下信息只有当retcode为SUCCESS时有返回
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
randomstr 随机字符串 随机生成的字符串 32  
trxid 交易单号 收银宝平台的交易流水号 20  
reqsn 商户交易单号 商户的交易订单号 32  
trxstatus 交易状态

交易的状态

对于刷卡支付,该状态表示实际的支付结果,其他为下单状态

4 详见附录
errmsg 错误原因 失败的原因说明 100  
payinfo 支付串 调起云闪付微信小程序的相关参数,商户解析出来后发起调用 不限 获取cqpMpPath和cqpMpAppId
sign 签名   32 详见安全规范

yinjr 2025年5月7日 15:48 收藏文档