4.3【银行子账户支付退款】接口


测试地址: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

业务返回说明

 

maxy2 2024年12月24日 11:35 收藏文档