APP签约支付接口
说明：请求银联app签约支付。同步返回银联签约支付tn号。商户前端通过tn号调银联控件跳转签约支付(富友也可以提供前端sdk)
说明：只有第一次调签约支付接口。跳转到银联云闪付签约支付成功后。后面支付。调订单支付接口同步免密扣款即可。
1 请求地址
生产地址：[详情请咨询富友对接群]
测试地址：[详情请咨询富友对接群]
2 接口输入
| 变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
|---|---|---|---|---|---|
| 商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
| 报文体 | message | MAX | 报文体密文(接口文档-接口概述-签名算法) | 必填 | OsxV9TKk5NzbD................ |
2.1 报文体
| 变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
|---|---|---|---|---|---|
| 商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
| 订单日期 | order_date | MAX(8) | 订单日期，由对接商户系统产生，格式：YYYYMMDD | 必填 | 20221110 |
| 订单号 | order_id | MAX(30) | 订单号：由商户端生成，条件：唯一，数字和英文组合 | 必填 | 2023F1110551545151212 |
| 订单金额 | order_amt | MAX(12) | 订单金额：整数，单位：分 | 必填 | 10000(分)=100(元) |
| 通知地址 | back_notify_url | MAX(200) | 订单支付成功，富友会根据此地址通知对接商户系统(POST) | 必填 | https://xxxxx.test.com/back.do |
| 商品名称 | goods_name | MAX(60) | 商品名称-大约15个中文 | 必填 | 比如：苹果手机 |
| 商品描述 | goods_detail | MAX(200) | 商品描述 | 必填 | 比如：买了一部苹果手机9000元 |
| 超时时间 | order_timeout | MAX(4) | 按分钟计算，1-360，不传默认120分钟 | 非必填 | 比如：1（1分钟） |
| 版本号 | ver | MAX(5) | 版本控制，目前是1.0.0版本 | 必填 | 1.0.0 |
| 银联签约订单号 | sign_order_id | MAX(30) | 银联APP签约支付的签约订单号。 | 必填 | 后面签约成功后。免密扣款用到 |
| 银联模板id | planid | MAX(30) | 银联模板id | 必填 | 银联入网成功后给商户的模板id |
3 接口输出
| 变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 说明 |
|---|---|---|---|---|---|
| 商户代码 | mchnt_cd | MAX(15) | 同上 | 必填 | |
| 应答码 | resp_code | MAX(4) | 应答码 | 必填 | |
| 应答描述 | resp_desc | MAX(200) | 应答描述 | 必填 | |
| 报文体 | message | MAX | 报文体 | 必填 | ADp7YzySKDrGI4UG6JcPwMVW3......... |
3.1 报文体
| 变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
|---|---|---|---|---|---|
| 商户号码 | mchnt_cd | MAX(15) | 同上 | 必填 | |
| 订单号 | order_id | MAX(30) | 同上 | 必填 | |
| 银联签约订单号 | sign_order_id | MAX(30) | 同上 | 必填 | |
| 银联tn号 | union_tn | MAX(32) | 银联tn号 | 必填 | 用于前端跳转银联APP签约支付 |