3.12自定义账单接口组

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310031

M

VERSION

版本

C(2)

04

M

DATA_TYPE

数据格式

N(1)

2：xml格式

M

LEVEL

处理级别

N(1)

0-9 0优先级最低，默认为5

M

MERCHANT_ID

商户代码

C(15)

商户ID

M

USER_NAME

用户名

C(1,20)

M

USER_PASS

用户密码

M

REQ_SN

交易批次号

C(40)

M

不重复流水

SIGNED_MSG

签名信息

C

M

FASTTRX

MERCHANT_ID

商户代码

C(15)

商户号ID

M

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

M

AGRMNO

协议号

C(22)

签约时返回的协议号

C

卡号和协议号其中一个必填，优先通过卡号匹配协议号

ACCOUNT_TYPE

账号类型

C(2)

00银行卡，02信用卡。不填默认为银行卡00。06:银联token账号

C

BANK_CODE

银行代码

C(8)

银行代码，存折必须填写。参见附录A.3银行代码

C

存折必填，银行卡视情况填写，详情见2.9.4银行代码说明针对账户类型传06的，必须上送银行代码

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

C

ACCOUNT_NAME

账号名

C(1,60)

银行卡或存折上的所有人姓名

M

AMOUNT

轮扣金额

C(12)

轮扣金额用|分隔，第一个金额为账单金额，后续金额依次减少。单位分

M

CURRENCY

货币类型

C(3)

人民币：CNY, 港元：HKD，美元：USD。不填时，默认为人民币。

C

ID_TYPE

开户证件类型

C(1)

参考A.1证件类型

C

ID

证件号

C(1,22)

C

TEL

手机号/小灵通

C(1,13)

C

CVV2

CVV2

C(3)

信用卡时必填

C

VALIDDATE

有效期

C(4)

信用卡时必填，格式MMYY(信用卡上的两位月两位年)

C

无需填写

CUST_USERID

自定义用户号

C(1,128)

商户自定义的用户号，开发人员可当作备注字段使用

C

REMARK

备注

C(1,50)

供商户填入备注信息。

C

SUMMARY

交易附言

C(1,140)

填入网银的交易备注,可以在网银明细中查询到该字段信息，但部分银行可能不支持

C

NOTIFYURL

通知地址

C(200)

交易无论成功还是失败都会通知到上送的地址，通知格式参考3.8.3快捷单笔交易结果通知

C

LEDGERS/

LEDGERDTL

SN

记录序号

C(1,4)

不能重复

C

MERCHANT_ID

分账商户号

C(10,20)

C

TYPE

分账类型

C (1)

1按比例分账

C

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310031

M

VERSION

版本

C(2)

03

M

DATA_TYPE

数据格式

N(1)

2：xml格式

M

REQ_SN

交易批次号

C(40)

M

RET_CODE

返回代码

C(4)

参考附录B6

M

ERR_MSG

错误信息

C(1,256)

C

SIGNED_MSG

签名信息

C

M

TRANSRET

RET_CODE

返回码

C(4)

参考附录B6

C

ERR_MSG

错误文本

C(1,256)

C

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310033

M

VERSION

版本

C(2)

04

M

DATA_TYPE

数据格式

N(1)

2：xml格式

M

LEVEL

处理级别

N(1)

0-9 0优先级最低，默认为5

M

MERCHANT_ID

商户代码

C(15)

商户ID

M

USER_NAME

用户名

C(1,20)

M

USER_PASS

用户密码

M

REQ_SN

交易批次号

C(40)

M

不重复流水

SIGNED_MSG

签名信息

C

M

REFUND

MERCHANT_ID

商户代码

C(15)

M

ORGBATCHID

原批次

C(0,60)

自定义账单交易中的REQ_SN的值

M

AMOUNT

退款金额

N(1,12)

整数，单位分

M

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

M

NOTIFYURL

通知地址

C(200)

C

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310033

M

VERSION

版本

C(2)

03

M

DATA_TYPE

数据格式

N(1)

2：xml格式

M

REQ_SN

交易批次号

C(40)

M

RET_CODE

返回代码

C(4)

参考附录B6

M

ERR_MSG

错误信息

C(1,256)

C

SIGNED_MSG

签名信息

C

M

TRANSRET

RET_CODE

返回码

C(4)

参考附录B6

C

ERR_MSG

错误文本

C(1,256)

C

SETTLE_DAY

清算日期

C(8)

YYYYMMDD

C

VOUCHERNO

银行流水号

C(1,46)

C

VERSION为06才返回该值

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310032

M

VERSION

版本

C(2)

04

M

DATA_TYPE

数据格式

N(1)

2：xml格式

M

LEVEL

处理级别

N(1)

0-9 0优先级最低，默认为5

M

MERCHANT_ID

商户代码

C(15)

商户ID

M

USER_NAME

用户名

C(1,20)

M

USER_PASS

用户密码

M

REQ_SN

交易批次号

C(40)

M

不重复流水

SIGNED_MSG

签名信息

C

M

QTRANSREQ

QUERY_SN

交易流水号

C(60)

交易流水号

M

MERCHANT_ID

商户号

C(15)

M

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310032

M

VERSION

版本

C(2)

03

M

DATA_TYPE

数据格式

N(1)

2：xml格式

M

REQ_SN

交易批次号

C(40)

M

RET_CODE

返回代码

C(4)

参考附录B6

M

ERR_MSG

错误信息

C(1,256)

C

SIGNED_MSG

签名信息

C

M

SMTDRET

BATCHID

原交易流水

C(60)

原请求交易中的REQ_SN的值

TRXCODE

交易类型

C(6)

BILLAMT

账单金额

N(1,12)

单位分

退款无

TRXAMT

实际发生金额

N(1,12)

单位分

原交易为自定义账单交易时表示实际成功金额；原交易为自定义账单退款时表示实际退款金额。

CNT

实扣次数

N(1,3)

退款无

FEE

手续费

N(1,12)

单位分

ACCOUNT_NO

交易账户

C(1,32)

脱敏账户

CUST_USERID

商户自定义流水

C (0,128)

原代收付请求报文中的CUST_USERID字段

SUMMARY

摘要

C(1,140)

FINTIME

交易完成时间

C(14)

SETTDAY

结算日期

C(8)

RET_CODE

返回码

C(4)

参考附录B6

C

ERR_MSG

错误文本

C(1,256)

C

URL参数名

说明

类型

取值

可空

备注

RETCODE

返回码

C(4)

非空

RETMSG

错误信息

C(256)

可空

ACCOUNT_NO

账号

N(1,32)

银行卡或存折号码

非空

AMOUNT

订单金额

N(1,12)

整数，单位分

非空

SUCCAMOUNT

实扣金额

N(1,12)

整数，单位分

非空

ACTUALCOUNT

实扣笔数

N(1,12)

整数

非空

SETTDAY

清算日期

C(8)

yyyyMMdd

非空

FINTIME

完成时间

C(14)

yyyyMMddHHmmss

非空

SUBMITTIME

提交时间

C(14)

yyyyMMddHHmmss

非空

BATCHID

交易批次号

C(40)

原请求报文中的交易流水REQ_SN

必填

POUNDAGE

手续费

N(12)

整数，单位分

可空

USERCODE

用户代码

C(20)

商户客户ID

必填

MERID

商户号

C(15)

商户号

必填

TRXCODE

交易类型

C(6)

自定义账单申请：310031，自定义账单退款申请：310033

必填

REMARK

备注

C(1,50)

可空

SIGN

签名

使用SHA1withRSA签名。签名原始内容为 账号|订单金额|实扣金额|实扣笔数|交易批次号|返回码|手续费

必填