测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2291
接口说明:
1.退款交易必须对应到原支付交易。
2.当原支付交易“平台商户自有资金交易类型”为C时,交易金额=原支付交易收款用户退款金额+平台商户自有资金退款金额;
3.当原支付交易“平台商户自有资金交易类型”为D时,交易金额+平台商户自有资金退款金额=原支付交易收款用户退款金额;
4.只能退180天以内的交易,如果上传订单号和子订单号则按照订单号查找原交易,如果不上传订单号则按照原交易流水号查找原交易;
注:针对华通银行,只支持一次全额退款(“tradeAmount-交易金额”等于“receiveAmount-收款用户收款金额”(且一次性全额退款))。
- 如果是T+0结算的,则直接从收款人账户把资金划转回退至付款人账户,资金明细类型记录为“余额支付退款”。
- 如果是T+1结算的,在未结算前发生退款,则先把收款人账户的那笔余额支付冻结的资金解冻,然后在从收款人账户把资金划转回退至付款人账户。在T+1日已结算后发生退款的则直接从收款人账户把资金划转回退至付款人账户。
5.订单子账户退款,无异步通知,接口实时响应。
业务请求参数
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
是 |
退款订单号 |
该笔业务订单由平台商户端生成的业务订单号 |
reqSubTraceNum |
String |
否 |
退款子订单号 |
该笔业务订单下每笔业务子订单由平台商户端生成的唯一标识 商户业务订单号+商户业务子订单号应保证唯一。 |
oriRespTraceNum |
String |
是 |
原通联订单号 |
|
receiverSignNum |
String |
是 |
原支付交易付款用户编号(资金转入方) |
|
receiverSubAcctNo |
String |
是 |
原支付交易付款用户银行子账号 |
上送银行用户编号 |
receiverName |
String |
是 |
原支付交易付款用户名称(资金转入方) |
|
payerSignNum |
String |
是 |
原支付交易收款用户编号(资金转出方) |
|
payerSubAcctNo |
String |
是 |
原支付交易收款用户银行子账号 |
上送银行用户编号 |
payerName |
String |
是 |
原支付交易收款用户名称(资金转出方) |
|
receiveAmount |
Long |
是 |
为原支付交易收款用户退款金额 |
|
tradeAmount |
Long |
是 |
交易金额,单位:分 |
为原支付付款用户退款金额 |
selfFlag |
String |
是 |
平台商户自有资金交易类型 |
N:无资金动账 D:扣平台自有资金登记薄 C:入平台自有资金登记薄 如不为N,应与原支付交易资金方向相反,即原支付交易该字段为D,退款交易该字段应为C。 当原支付交易“平台商户自有资金交易类型”为C时(退款交易该字段送D),交易金额=原支付交易收款用户退款金额+平台商户自有资金退款金额 当原支付交易“平台商户自有资金交易类型”为D时(退款交易该字段送C),交易金额+平台商户自有资金退款金额=原支付交易收款用户退款金额 华通银行,此字段仅上送“N:无资金动账” |
selfAmount |
Long |
是 |
P_ SELF _FLAG为N时,该字段应为0 “中信银行托管”,必填; 华通银行,上送0; |
|
fundType |
String |
否 |
资金类型/商品名称 |
|
remark |
String |
否 |
备注 |
响应请求参数
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
否 |
通联订单号 |
必填字段校验均通过,返回此字段 |
chnlTradeCode |
String |
否 |
中信侧交易流水号 |
业务返回码=00000,返回 |
chnlTradeDate |
String |
否 |
中信侧交易日期 |
|
chnlTradeTime |
String |
否 |
中信侧交易时间 |
|
respCode |
String |
是 |
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
否 |
业务返回说明 |