4.6自带参数的当面付订单接口

商户在自己的平台支付的时候把订单号或者交易金额作为参数,跳到当面付的支付页面,当面付查询订单并展示给用户支付。

## 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 | 否  | 签名    | 32  | 详见安全规范                            |

在不传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为: https://syb-test.allinpay.com/usertrans/cuspay?amt=1&appid=00000051&c=00E0RTd5&oid=011700134737&sign=6962A1E413A57195D7FA9A08C20DF855&signtype=RSA&trxreserve=05|Q1#æè¥¿|Q2#186-2828-9999|Q3#å¹¿å·å¸å¤©æ²³åºä½è²è¥¿è·¯107å·|X#å¶ä»å¤æ³¨ä¿¡æ¯

或者将此url生成二维码,给用户扫一扫或直接由开发者系统重定向跳转。
注:
1，生产环境为https://syb.allinpay.com/sappweb/usertrans/cuspay
2，returl及trxreserve参与签名不需要做urlencode，但需要urlencode后组到url后面的参数中.见上方示例跳转url的trxreserve。