生产接口地址: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 | 交易透传信息 | 是 | - | 支付确认时需原样带上本字段信息 |