商户在自己的平台支付的时候把订单号或者交易金额作为参数,跳到当面付的支付页面,当面付查询订单并展示给用户支付。
1.业务场景
场景1：商户商城下单后,点击支付,把订单号带上,跳往当面付页面,当面付根据订单号查询商户订单信息,并展示给用户确认支付
场景2：订单二维码收款
商户用自己的订单号或者金额,按照当面付的规范,生成一个二维码,发给付款人,付款人扫一扫,确认订单,然后支付,完成订单收款
2.请求参数
| 字段名称 | 类型 | 可空 | 说明 | 长度 | 备注 |
|---|---|---|---|---|---|
| appid | String | 否 | 通联分配的appid | 8 | |
| c | String | 否 | 二维码ID | 20 | 通联分配的二维码编号 |
| oid | String | 是 | 订单编号 | 50 | Oid和amt 不能同时为空 |
| unireqsn | String | 是 | 唯一订单编号 | 50 |
unireqsn与原订单号oid二选一当2个订单号并存时， 优先取原oid的订单号原有逻辑。 oid订单号原有逻辑，同一订单号在微信/支付宝/云闪付等渠道可以同时存在下单。 |
| amt | String | 是 | 交易金额 | 12 | 单位:分 |
| returl | String | 是 | 成功支付跳转地址 | 128 | 必须为https协议地址，且不允许带参数。trxreserve必填 |
| trxreserve | String | 是 | 业务备注信息 | 160 | 参见订单详情标签个性化说明 |
| submittime | String | 是 | 截止支付时间 | 20 | yyyyMMddHHmmss |
| signtype | String | 否 | 签名方式 | 8 | RSA/SM2 |
| extendparams | String | 否 | 拓展参数 | json字符串，注意是String一般用于渠道的活动参数填写 | |
| sign | String | 否 | 签名 | 256 | 详见安全规范 |
| asinfo | String | 是 | 分账参数 | 1024 |
格式: cusid:type:amount;cusid:type:amount… 其中 cusid:接收分账的通联商户号 type分账类型（01：按金额 02：按比率） 如果分账类型为02，则分账比率为0.5表示50%。 如果分账类型为01，则分账金额以元为单位表示 |
在不传trxreserve情况下，且订单编号和交易金额都传了的话，优先处理接口金额,用户不允许修改交易金额
如果只传订单编号,则对接商户订单系统，查询商户的订单金额作为支付金额
如trxreserve按照6.3标签组包，且oid订单号及amt交易金额不为空，则系统默认amt的交易金额，但不发起订单查询，并会保存oid到交易明细。
当面付地址为:
测试环境:
https://syb-test.allinpay.com/sappweb/usertrans/cuspay
生产环境:
https://syb.allinpay.com/sappweb/usertrans/cuspay
保险实名支付地址
测试环境：
https://syb-test.allinpay.com/apiweb/insdmf/cuspay
生产环境
https://syb.allinpay.com/apiweb/insdmf/cuspay
3.处理逻辑
例如测试环境
参数:appid=00000051
key=allinpay888
c=00E0RTd5
oid=011700134737
amt=1
signtype=RSA
trxreserve=05|Q1#文西|Q2#186-2828-9999|Q3#广州市天河区体育西路107号|X#其他备注信息
签名明文串signSrc : amt=1&appid=00000051&c=00E0RTd5&oid=011700134737&signtype=RSA&trxreserve=05|Q1#文西|Q2#186-2828-9999|Q3#广州市天河区体育西路107号|X#其他备注信息
生成签名sign=SybUtil.rsaSign(string,cusRsaPrivateKey,”utf-8”)
当面付的页面为https://syb-test.allinpay.com/sappweb/usertrans/cuspay
或者将此url生成二维码,给用户扫一扫或直接由开发者系统重定向跳转。
注:
1，生产环境为https://syb.allinpay.com/sappweb/usertrans/cuspay
2，returl及trxreserve参与签名不需要做urlencode，但需要urlencode后组到url后面的参数中.见上方示例跳转url的trxreserve。