测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2098
接口说明:
1.商户业务订单号+商户业务子订单号应保证唯一。
2.登记簿预付交易使用方式:
——通过616文件进行资金清分到担保交易登记簿。
——平台商户业务订单明细文件(616),3 -预付交易支付,用户编号固定为平台担保资金登记簿,值同“平台商户编号”
门店完成担保交易。
——登记簿预付(21000028),transType交易类型:02-预付交易完成,资金从担保到用户登记簿
担保交易完成后存在退款
——登记簿预付(21000028),transType交易类型:03-预付完成撤销,资金从用户到担保登记簿
——通过616文件,支付订单交易类型:2-退货;业务订单交易类型:4 -预付交易撤销
3.登记簿预付支付,无异步通知,接口实时响应。
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
signNum |
String |
60 |
是 |
会员号 |
|
subAcctNo |
String |
15 |
是 |
银行子账号 |
|
acctName |
String |
64 |
是 |
银行用户名称 |
|
transType |
String |
2 |
是 |
交易类型 |
00:预付交易支付 01:预付交易撤销 02:预付交易完成 03:预付完成撤销 |
reqTraceNum |
String |
60 |
是 |
商户业务订单号 |
该笔业务订单由平台商户端生成的业务订单号
|
reqSubTraceNum |
String |
60 |
否 |
商户业务子订单号 |
该笔业务订单下每笔业务子订单由平台商户端生成的唯一标识 商户业务订单号+商户业务子订单号应保证唯一。 |
transDt |
String |
8 |
是 |
交易日期 |
实际交易发生日期,以平台商户记录的时间为准,格式YYYYMMDD。 |
transTm |
String |
6 |
是 |
交易时间 |
实际交易发生时间,以平台商户记录的时间为准,格式HHmmss |
amount |
Long |
20 |
是 |
交易金额 |
单位:分 |
discountAmt |
Long |
20 |
否 |
平台优惠金额 |
单位:分 |
devideAmt |
Long |
20 |
否 |
平台分成金额 |
单位:分 |
fundType |
String |
6 |
是 |
资金类型 |
联系银行同事获取 |
contractId |
String |
100 |
否 |
合同编号 |
该笔交易中涉及的收付款双方签订的合同编号 |
memo |
String |
100 |
否 |
备注 |
自定义,反映在银行子账户明细以及电子回单中 |
reqReserved |
String |
500 |
否 |
发起方保留域 |
业务响应参数
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
result |
String |
否 |
订单状态 |
|
respTraceNum |
String |
是 |
通联订单号 |
|
reqTraceNum |
String |
是 |
商户订单号 |
|
respCode |
String |
是 |
业务返回码 |
|
respMsg |
String |
是 |
失败原因 |
|
chnlTradeCode |
String |
否 |
银行侧交易流水号 |
|
chnlTradeDate |
String |
否 |
银行侧交易日期 |
|
chnlTradeTime |
String |
否 |
中信侧交易时间 |