4.4支付确认


生产接口地址:https://vsp.allinpay.com/apiweb/qpay/payagreeconfirm
测试接口地址:https://syb-test.allinpay.com/apiweb/qpay/payagreeconfirm

使用场景:商户提交快捷支付请求后,进行支付确认

trxstatus交易状态:

0000:交易成功,交易流程完成
1999: 短信验证码已发送,请继续调用支付确认接口(即本接口)完成支付
2008/2000: 交易处理中,请调用交易查询接口确认交易结果
其他,交易失败

注:支付确认短信验证码有效时间为2分钟

请求参数:

参数 参数名称 取值 可空 最大长度 备注
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  
smscode 短信验证码   10  
thpinfo 交易透传信息   - 支付申请或者错误码为1999返回的thpinfo原样带上

响应参数:

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

此字段是通信标识,非交易结果

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

retmsg 返回码说明   100  
randomstr 随机字符串 随机生成的字符串 32 SUCCESS返回
sign 签名 详见安全规范 32 SUCCESS返回
当retcode为SUCCESS时有返回
trxstatus 交易状态

交易的状态

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

其余详看说明

4 详见交易返回码说明
errmsg 错误原因 失败的原因说明 100  
reqsn 商户订单号   32  
trxid 交易单号 平台的交易流水号 20 交易成功返回
chnltrxid 渠道平台交易单号   50 交易成功返回
fintime 交易完成时间 yyyyMMddHHmmss 14 交易成功返回
fee 交易手续费 单位:分 20  
thpinfo 交易透传信息   - trxstatus=1999时,需再次提交支付确认,原样带上本字段信息

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