接口地址
生产环境：https://vsp.allinpay.com/apiweb/tlfqf/jfqpay
测试环境：https://syb-test.allinpay.com/apiweb/tlfqf/jfqpay
使用场景：
聚分期下单
请求参数：
| 参数 | 参数名称 | 取值 | 可空 | 最大长度 | 备注 |
|---|---|---|---|---|---|
| orgid | 机构号 | 平台分配机构号 | 是 | 15 | |
| appid | 应用ID | 平台分配的机构APPID | 否 | 8 | |
| signtype | 签名方式 |
RSA RSA2 SM2 |
否 | 8 | |
| encrypttype |
敏感信息 加密方式 |
暂只支持SM4 对接参数需配置SM4密钥 |
否 | 4 | 默认SM4 |
| version | 版本号 | 接口版本号 | 可 | 2 | 12 |
| randomstr |
随机字符 串 |
商户自行生成的随机字符串 | 否 | 32 | |
| cusid | 商户号 | 商户号 | 否 | 8 | |
| reqsn |
商户订单 号 |
否 | 50 | ||
| trxamt | 交易金额 | 单位：分 | 否 | 15 | |
| validtime | 有效时间 |
订单有效时间 以分为单位 不填默认为5分钟 |
是 | 4 | |
| remark | 备注 | 是 | 160 | 保存在通联交易明细备注 | |
| unpid | 银联PID | 银联服务商机构编码 | 是 | 32 | 仅支持代理商/服务商上送 |
| maskedacctno | 卡号掩码 |
格式：前6后4，中间4个*符号 如：621416****9573 |
是 | 16 |
商户限定卡号掩码支付 需同时上送用户手机号码 仅在联合登陆场景下使用。 |
| bankcode | 指定银行 |
示例：03050000 为指定民生银行 |
是 | 16 |
商户指定银行分期支付，则填上该值。 仅支持指定单一银行， 银行编码详见附录 若上送了卡号或卡号掩码无需上送改字段 若上送需与卡号对应银行保持一致 |
| fqnum |
限定分期 期数 |
示例：3&6&9 | 是 | 32 |
商户指定分期期数， 多个期数用&分隔，例如3&6&9 |
| senceflag | 场景标识 |
01:保险实名认证支付 02：联合登陆 01与02场景均需要向银联申请白名单权限 |
是 | 2 |
（1）联合登陆，手机号码必填，登陆状态设置为1。 在商户未申请银联联登权限成功下，该联登报文不生效 送了联登信息过去，下单报文仍返回普通分期交易码 （2）保险实名 需送实名信息在未取得保险实名权限下 该内容无法实现保险实名逻辑， 下单报文仅返回普通分期交易码 |
| idno | 证件号 |
实名交易必填. 填了此字段就会验证证件号和姓名 |
是 | 32 |
需SM4加密 senceflag在01场景下需要送 |
| truename |
付款人真 实姓名 |
实名交易必填. 填了此字段就会验证证件号和姓名 |
是 | 32 |
需SM4加密 senceflag在01场景下需要送 |
| mobile | 手机号 | 是 | 13 |
需SM4加密 联合登陆场景下上送用户手机号 手机号需加密上送 （白名单商户才能 支持联登） |
|
| loginstatus | 登陆状态 |
0-未登录 1-已登录 不上送默认为0 |
是 | 1 |
联合登陆场景下上送登陆状态， 表明用户在商户侧的登陆状态 |
| notify_url |
交易结果 通知地址 |
接收交易结果的通知回调地址 通知url必须为直接可访问的url 不能携带参数。 https只支持默认端口 |
否 | 256 | 若使用https,需使用默认443端口 |
| front_url |
页面跳转 同步通知 页面路径 |
|
是 | 256 | 详见4.8同步结果通知 |
| rettype |
同步返回 请求方式 |
交易完成后 平台会按照此请求方式 提交到商户上送的同步通知地址 |
是 | 2 |
默认为POST方式 01 POST方式 02 GET方式 |
| extendparams | 拓展参数 |
json字符串，注意是String 一般用于渠道的活动参数填写 |
是 | 参考附录说明-拓展参数 | |
| sign | 签名 | 否 | 256 | 详见安全规范 |
响应参数：
| 字段ID | 字段名称 | 取值 | 可空 | 最大长度 | 备注 |
|---|---|---|---|---|---|
| retcode | 返回码 | SUCCESS/FAIL | 否 | 8 | 此字段是通信标识，非交易结果 |
| retmsg | 返回码说明 | 是 | 100 | ||
| 以下信息只有当retcode为SUCCESS时有返回 | |||||
| cusid | 商户号 | 否 | 15 | ||
| appid | 机构appid | 否 | 8 | ||
| payinfo | 支付信息 | 否 | 256 |
下单成功后，银联侧响应的聚分期付款url， 开发者转化为qrcode给用户扫一扫或者直接做重定向跳转 |
|
| errmsg | 错误信息 | 失败的原因信息 | 是 | 100 | |
| reqsn | 支付下单请求订单号 | 否 | 50 | ||
| trxid | 收银宝平台交易流水号 | 否 | 18 | ||
| sign | 签名 | 否 | 256 | 详见安全规范 | |