4.3支付申请


生产接口地址:https://vsp.allinpay.com/apiweb/qpay/payapplyagree
测试接口地址:https://syb-test.allinpay.com/apiweb/qpay/payapplyagree
注:重发支付短信验证码需间隔30秒以上

使用场景:通过协议号发起支付申请

返回处理说明:

trxstatus交易状态:
0000:交易成功,交易流程完成,无需支付确认
1999: 短信验证码已发送,请继续调用支付确认接口完成支付
2008/2000:交易处理中,请查询交易
其他3开头,交易失败

请求参数:

参数 参数名称 取值 可空 最大长度 备注
cusid 商户号 通联分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 接口版本号 2 默认填11
reqip 请求ip   32  
reqtime 本次请求时间   16 yyyyMMddHHmmss
randomstr 随机字符串 商户自行生成的随机字符串 32  
signtype 签名类型   8

RSA

SM2

sign 签名 详见安全规范 32  
reqsn 商户订单号   32  
agreeid 协议编号   32 签约返回
amount 订单金额   20 单位分
currency 币种   8 暂只支持CNY
subject 订单内容 订单的展示标题 100  
trxreserve 交易备注 用于用户订单个性化信息,交易完成通知会带上本字段。 160  
notifyurl 交易结果通知地址

接收交易结果通知回调地址

通知url必须为直接可访问的url,不能携带参数。

256  
asinfo 分账信息

格式:cusid:type:amount;cusid:type:amount…

其中

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

type分账类型(01:按金额  02:按比率)

如果分账类型为02,则分账比率为0.5表示50%。

如果分账类型为01,则分账金额以元为单位表示

1024 开通此业务需开通分账配置

响应参数:

字段ID 字段名称 取值 可空 最大长度 备注
retcode 返回码 SUCCESS/FAIL 8  
retmsg 返回码说明   100  
randomstr 随机字符串 随机生成的字符串 SUCCESS返回
sign 签名 详见安全规范 32 SUCCESS返回
当retcode为SUCCESS时有返回
reqsn 商户订单号   32  
trxstatus 交易状态

交易的状态

0000:交易成功,交易流程完成

其余详看说明

4 详见交易返回码说明
errmsg 错误原因 失败的原因说明 100  
trxid 交易单号 平台的交易流水号 20 交易成功返回
chnltrxid 渠道平台交易单号   50 交易成功返回
fintime 交易完成时间 yyyyMMddHHmmss 14 交易成功返回
thpinfo 交易透传信息   - 支付确认时需原样带上本字段信息

yinjr 2024年9月3日 15:06 收藏文档