接口描述
商户需开发“文件传输类交易”接口获取对账文件。
请求方式
POST
生产调用地址
https://api.test.95516.com/file/upntAcp/trans.do
测试调用地址
https://api.95516.com/file/upntAcp/trans.do
公共参数
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 版本号 | version | String(1..8) | M-必填 |
7.0.1 |
||
| 发送方系统索引号 | appId | String(1..32) | M-必填 |
当普通商户直连接入、平台类商户接入时，填商户号。 当收单机构接入时，填收单机构号。 |
||
| 发送方索引类型 | appType | String[2] | M-必填 |
本数据元的填写须根据报文发送方的实际角色进行填写。 当普通商户直连接入、平台类商户接入时，填02。 当收单机构接入时，填01。 |
||
| 接口类型 | bizMethod | String(1..64) | M-必填 |
bizMethod 取值为：upntAcp.trade.file |
||
| 发送方流水号 | reqId | String(1..64) | M-必填 |
由发送方自行生成，保证每笔请求不重复。同步应答原样返回，异步应答生成新值。 |
||
| 签名 | sign | String(1..344) | M-必填 |
对报文摘要的签名 |
||
| 证书ID | signId | String(1..128) | M-必填 |
签名证书序列号（十进制） |
||
| 签名或摘要方式 | signMethod | String(1..20) | M-必填 |
取值详见技术规范 |
请求业务参数
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 接入类型 | accessType | String[1] | M-必填 |
0：普通商户直连接入1：收单机构接入2：平台类商户接入 |
||
| 收单机构代码 | acqInsCode | String(8..11) | C-按条件必填 |
已被批准加入银联互联网系统的收单机构代码 接入类型为收单机构接入时需上送 |
||
| 商户代码 | merId | String[15] | C-按条件必填 |
已被批准加入银联互联网系统的商户代码固定15位长，仅支持数字和字母 |
||
| 交易发送时间 | txnTime | String[14] | M-必填 |
商户发送交易时间，格式： yyyyMMddHHmmss |
||
| 文件类型 | fileType | String[2] | M-必填 |
依据实际业务情况而定，默认：00 |
||
| 请求方保留域 | reqReserved | String(1..1024) | O-选填 |
商户自定义保留域，交易应答时会原样返回 |
||
| 清算信息域 | settleInfo | Object | M-必填 | 查看详情 |
同步应答业务参数
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 应答码 | code | String[10] | M-必填 |
对调用结果进行统一归类，指导开发者判断并进行后续业务操作。数据字典见附录A《应答码》。 |
||
| 应答码描述 | msg | String(1..128) | M-必填 |
同一个应答码可对应多个不同的描述，对处理结果进行详细提示。 |
||
| 详细应答码 | subCode | String[10] | M-必填 |
描述了详细的业务处理失败的原因，详见每个交易接口说明，仅用于问题排查和分析，无须开发者判断。 |
||
| 详细应答码描述 | subMsg | String(1..128) | M-必填 |
同一个详细错误码可对应多个不同的描述，对处理结果进行详细提示。 |
||
| 接入类型 | accessType | String[1] | R-需要返回 |
0：普通商户直连接入1：收单机构接入2：平台类商户接入 |
||
| 收单机构代码 | acqInsCode | String(8..11) | R-需要返回 |
已被批准加入银联互联网系统的收单机构代码 |
||
| 商户代码 | merId | String[15] | R-需要返回 |
已被批准加入银联互联网系统的商户代码固定15位长，仅支持数字和字母 |
||
| 交易发送时间 | txnTime | String[14] | R-需要返回 |
商户发送交易时间，格式： yyyyMMddHHmmss |
||
| 请求方保留域 | reqReserved | String(1..1024) | C-按条件必填 |
商户自定义保留域，交易应答时会原样返回 |
||
| 清算信息域 | settleInfo | Object | R-需要返回 | 查看详情 | ||
| 文件类型 | fileType | String[2] | R-需要返回 |
依据实际业务情况而定，默认：00 |
||
| 文件名 | fileName | String(1..64) | M-必填 |
填写文件名称 |
||
| 批量文件内容 | fileContent | String(1..1000000) | M-必填 |
压缩，Base64编码后的文件内容 |
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
