Appearance
业务交易接口
本章节描述商户接入金运通实名代付平台相关业务接口。
单笔代付交易
交易说明
根据商户的付款请求将资金划转到企业或个人的银行账户。
交易代码
TC1002
使用时机
需要向用户银行卡的付款时使用。
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 商户平台虚拟账户 | merViralAcct | CHAR(30) | O | 由平台为商户分配，默认不传 |
| 2. | 协议号 | agrtNo | CHAR(30) | O | 暂未使用 |
| 3. | 银行名称 | bankName | CHAR(60) | O | 代付银行账户银行全名称（上送时校验卡号和银行名称的所属关系） |
| 4. | 银行账号 | accountNo | CHAR(32) | M | 代付银行账号 |
| 5. | 银行账户名称 | accountName | CHAR(60) | M | 银行账户名称 |
| 6. | 账户类型 | accountType | CHAR(2) | M | 00：对私 |
| 7. | 开户行所在省 | brachBankProvince | CHAR(20) | O | 不带“省”或“自治区”，如北京、浙江，内蒙古等。 |
| 8. | 开户行所在市 | brachBankCity | CHAR(30) | O | 不带“市”，如北京，杭州等。 |
| 9. | 开户行名称 | brachBankName | CHAR(60) | O | 银行账户开户所在银行网点的名称。 |
| 10. | 开户行行号 | brachBankCode | CHAR(12) | O | 开户行联行号（对私不用传，对公代付建议上传，可降低退汇概率） |
| 11. | 交易金额 | tranAmt | NUMBER(15,2) | M | 代付的金额,保留小数2位。 |
| 12. | 币种 | currency | CHAR(3) | M | 人民币：CNY |
| 13. | 业务类型代码 | bsnCode | CHAR(5) | M | 代付的业务类型，取值见“代付产品特性表”。 |
| 14. | 开户证件类型 | certType | CHAR(2) | O | 01：身份证； |
| 15. | 开户证件号 | certNo | CHAR(20) | O | 证件号 |
| 16. | 手机号码 | mobile | CHAR(13) | O | 手机号 |
| 17. | 摘要信息 | remark | CHAR(100) | O | 摘要信息 |
| 18. | 预留字段 | reserve | CHAR(100) | O | 预留字段 |
响应字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 交易状态 | tranState | Char(2) | O | 00：代付受理成功 |
| 2. | 备注信息 | remark | Char(60) | O | 交易结果说明 |
单笔代付查询
交易说明
用于商户单笔查询代付的交易结果状态。
交易代码
TC2002
使用时机
单笔代收交易返回的交易状态未确定时使用。
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 原交易流水号 | oriTranFlowid | Char(32) | M | 代付原交易流水号 |
响应字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 交易响应码 | tranRespCode | Char(8) | M | 交易响应码 |
| 2. | 交易响应描述 | tranRespDesc | Char(50) | M | 对交易响应码的说明 |
| 3. | 交易状态 | tranState | Char(2) | M | 00：代付受理成功 |
| 4. | 备注信息 | remark | Char(60) | O | 交易结果说明 |
单笔代付通知
交易说明
用于单笔通知商户实名代付交易的交易结果状态。
交易代码
TC3002
使用时机
对于异步处理交易或结果未明的交易有明确的交易结果时通知商户。
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 原交易流水号 | oriTranFlowid | Char(32) | M | 商户代付原交易流水号 |
| 2. | 银行账号 | accountNo | CHAR(32) | M | 代付银行账号 |
| 3. | 银行账号名称 | accountName | CHAR(60) | M | 代付银行账号名称 |
| 4. | 交易金额 | tranAmt | NUMBER(15,2) | M | 银行卡收到的金额,保留小数2位。整数位最大为13位。 |
| 5. | 交易响应码 | tranRespCode | Char(8) | M | 响应码。 |
| 6. | 交易响应描述 | tranRespDesc | Char(50) | M | 对交易响应码的说明 |
| 7. | 交易状态 | tranState | Char(2) | M | 01：代付成功 |
| 8. | 备注信息 | remark | Char(60) | O | 交易结果说明 |
响应字段
注：如果商户在报文头中的响应码返回非S0000000，表示回调处理异常，继续发送通知，最多发送6次。不返回或者随意返回字符串时，http响应码为200默认通知成功，不再通知。
虚拟账户余额查询
交易说明
查询商户指定虚拟账号的当前实际余额情况。查询实时返回结果。
交易码
TC2020
使用时机
商户需要查看虚拟账户余额时。
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 虚拟账号 | merViralAcct | Char(32) | O | 查询的指定虚拟帐号 |
响应字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 查询时间 | queryTime | Char(14) | M | 查询余额的时间点，格式：yyyymmddMMHHSS |
| 2. | 虚拟账号 | merViralAcct | Char(32) | M | 查询的指定商户平台虚拟帐号 |
| 3. | 账户余额 | balance | NUMBER(15,2) | M | 虚拟帐号的金额,保留小数2位。整数位最大为13位。 |
单笔代付回单
交易说明
用于商户单笔获取代付的PDF回单文件，返回的是Base64格式的字符串，需商户自行转换为PDF文件。
交易代码
TC2023
使用时机
单笔代付交易返回的交易状态成功时使用。
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 原交易流水号 | ori_tran_flowid | Char(32) | M | 代付原交易流水号 |
响应字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 回单文件 | receipt | Char | M | PDF文件转Base64 |