测试环境：

http://47.95.131.62:8080/api/v1/pay/bankcard/refund

请求参数(O-非必传 ,M-必传):

  • 部分退款最多不能超过15次
  • 本接口无需包含接口公共参数，仅传输下列参数即可：
参数 参数名称 类型 参数说明 样例 可空
merch_no 商户编号 String 原交易商户编号(v1.42增加) M
tradeId 原交易id String SaaS平台的交易订单编号 M
batchNo 批次号 String O
validDate 卡有效期 String O
outTradeNo 外部流水号 String M
accessid 接入机构标识 String M
notifyUrl 通知地址 String 交易成功后的异步通知地址 O
mac 消费报文的签名值 String HEX编码 针对除mac参数以外的其它参数的签名值 M
requestData 撤销报文 JSON M

requestData

参数 参数名称 类型 参数说明 样例 可空
f2 主帐号 N22 手输卡号时上送字段,必传 6217966545622511 O
f3 交易处理码 N6 固定为200000 200000 M
f4 交易金额 N12 以分为单位，退货金额 M
f11 受卡方系统跟踪号 N6 POS终端交易流水为6位数字，值从1至999999循环使用 000010 M
f22 服务点输入方式码 N3 011、012、021、051、071、022、052、072、911 051 O
f23 卡序列号 N3 IC卡交易时必填 O
f25 服务点条件码 N2 00 M
f26 服务点PIN获取码 N2 12 O
f35 2磁道数据 z…37 (V1.10修改)22域磁条输入且存在二磁道信息(人脸支付获取人脸路由接口返回的token值进行上送) O
f36 3磁道数据 z…104 22域磁条输入且存在三磁道信息 O
f41 受卡机终端标识码 ANS…50 SaaS终端编号 M
f49 交易货币代码 an3 人民币的货币代码为156 156 M
f52 个人标识码数据 b64 对于磁条卡交易和手机芯片交易有PIN时必选；对于基于PBOC借/贷记标准的IC卡交易，当使用脱机密码验证时，该域不出现；当使用联机密码验证时，该域出现 O
f55 IC卡数据域 最大255字节数据 以下子域中的M仅当该交易为IC卡交易时有效 O
9F26（tag） 应用密文 b64 M
9F27（tag） 应用信息数据 b8 M
9F10（tag） 发卡行应用数据 b…256 M
9F37（tag） 不可预知数 b32 M
9F36（tag） 应用交易计数器 b16 M
95（tag） 终端验证结果 b40 M
9A（tag） 交易日期 n6 M
9C（tag） 交易类型 n2 M
9F02（tag） 交易金额 n12 M
5F2A（tag） 交易货币代码 n3 M
82（tag） 应用交互特征 b16 M
9F1A（tag） 终端国家代码 n3 M
9F03（tag） 其它金额 n12 M
9F33（tag） 终端性能 b24 M
9F34（tag） 持卡人验证结果 b24 O
9F35（tag） 终端类型 n2 O
9F1E（tag） 接口设备序列号 an8 如果终端标识不能隐含确定接口设备序列号，则出现 O
84（tag） 专用文件名称 b…128 O
9F09（tag） 应用版本号 b16 O
9F41（tag） 交易序列计数器 n…4 O
9F63（tag） card_pro_id b…128 当终端能够获取该卡域信息时，本域出现；否则，本域不出现。 O
f61 原始信息域 z…290 原消费时间，格式为YYMMDD M

返回参数:

  • 本接口返回参数不包含接口公共参数
参数 参数名称 类型 参数说明 样例 可空
responseData 返回报文 JSONObject result为0时返回 O
responseData开始
f39 应答码 an2 M
f61 银行参考号 z…290 O
f55 IC卡数据域 最大255字节数据 当该交易为运通IC卡交易时有效(v1.44增加) O
responseData结束
tradeId 退货订单号 String result为0时返回，SaaS平台的订单编号 O
unionRefNo 银联参考号 String result为0时返回，银联参考号 O
bankIssno 发卡机构代码 String result为0时返回，发卡机构代码 O
tradeEndTime 交易完成时间 String result为0时返回 O
mac 返回报文的签名值 String HEX编码 针对除mac参数以外的其它参数的签名值，result为0时返回 O
result 业务结果 String 0 : 成功；1 : 失败 M
msg 错误信息 String result为1时显示错误信息；F39非00（成功）时解析显示错误信息 O
totalAmount 原消费交易总金额 String 原消费交易总金额(v1.30增加) M
refundedAmount 已退款金额 String 已退款金额(v1.30增加) M
remanentAmount 剩余可退款金额 String 剩余可退款金额(v1.30增加) M
cardOrg 卡组织(v1.44增加) String result为0时返回，卡组织 银联：UNION，运通：EXPRESS O
currency 币种(v1.44增加) String result为0时返回，币种 人民币卡：CNY，外卡：OUT O
文档更新时间: 2024-12-26 10:26   作者：周岳