生产地址: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 | 备注 | 备注信息 | 否 | 160 | 最大300个字节(80个中文字符) |
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 | 详见安全规范 |