业务说明
支持的交易类型:4.34网银支付、4.65快捷支付申请、4.67快捷支付页面版
交易请求报文
JSON:
{
"request_type": "online_refund_request",
"isspid": "39493002",
"pos_id": "8888888888",
"store_id": "8888888888",
"pos_seq": "2018121400000006",
"user_id": "user01",
"system_id": "8888",
"device_type": "4",
"device_ip": "127.0.0.1",
"memo": "订单备注",
"online_refund_request": {
"tx_amt": "1",
"org_pos_seq": "2018121400000001",
"extend_params": {
"split_info": {
"keep_amt": "800",
"split_list": [
{
"merchant_id": "10000000000001",
"div_amt": "150"
},
{
"merchant_id": "10000000000002",
"div_amt": "50"
}
]
}
}
},
"sign": "E622B688C360F8444788740B111E4787"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>online_refund_request</request_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<store_id>1511300001</store_id>
<pos_seq>1511300000004</pos_seq>
<user_id>user01</user_id>
<system_id>8888</system_id>
<device_type>4</device_type>
<device_ip>127.0.0.1</device_ip>
<memo>订单备注</memo>
<online_refund_request>
<tx_amt>10</tx_amt>
<org_pos_seq>1511300000001</org_pos_seq>
<extend_params><![CDATA[扩展参数(JSONObject)]]></extend_params>
</online_refund_request>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
request_type | 请求类型 | String(32) | 固定值:online_refund_request | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
store_id | 门店号 | String(20) | 商户自定义门店号 | 必填 |
pos_seq | 退款请求流水号 | String(32) | 同一个翼码商户号下唯一,不可重复使用,且大于12位 | 必填 |
user_id | 操作员标识 | String(20) | 操作员号 | 可空 |
system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
device_type | 设备类型 | String(1) | 1:手机 2:平板 3:手表 4:PC 发起交易设备的类型 | 必填 |
device_ip | 设备IP | String(15) | 发起交易设备的公网IP | 必填 |
memo | 订单备注 | String(128) | 可空 | |
online_refund_request ->tx_amt | 退款金额 | Number(9) | 单位为分 | 必填 |
online_refund_request ->org_pos_seq | 支付请求流水号 | String(32) | 被退款的支付请求流水号,且大于12位 | 必填 |
online_refund_request ->extend_params | 扩展参数 | JSONObject | 用于扩展一些特殊的支付参数字段,详细参数见下表 使用XML格式报文时,建议使用CDATA标签包裹内容 | 可空 |
extend_params 扩展参数
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
split_info | JSON | 分账信息 接口指定分账规则进行实时分账的交易在部分退款时,退款必须传入分账信息,否则会报错。。 部分支付通道不支持分账金额退回。 | 可空 |
split_info 分账信息
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
keep_amt | String | 从分账方自留金额中退款的金额,单位为分,可传0表示不从自留中退 | 必填 | 1000 |
split_list | JSONArray | 分账明细 | 可空 |
split_list 分账明细
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
merchant_id | String | 分账接收方的分账商户号 | 必填 | 10000000000001 |
div_amt | String | 从分账金额中退款的金额,单位为分,必须大于0 | 必填 | 1000 |
extend_params 样例:
{
"split_info": {
"keep_amt": "800",
"split_list": [
{
"merchant_id": "10000000000001",
"div_amt": "150"
},
{
"merchant_id": "10000000000002",
"div_amt": "50"
}
]
}
}
交易返回报文
JSON:
{
"response_type": "online_refund_response",
"system_id": "8888",
"isspid": "39493002",
"pos_id": "8888888888",
"pos_seq": "2018121400000006",
"trans_time": "20181214145332",
"sys_seq": "b7ff9fa5bb4355e2",
"pay_type": "517",
"res_info": {
"trade_no": "4200000196201812146252898537",
"out_trade_no": "2018121400000002",
"refund_amt": 1,
"refund_time": "20221113203144"
},
"result": {
"id": "0000",
"comment": "退款成功"
},
"sign": "207482F2C0A998B73F388B8AA401DB76"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>online_refund_response</response_type>
<isspid>39493002</isspid>
<pos_id>123456789</pos_id>
<pos_seq>000000000001</pos_seq>
<sys_seq>000000000244</sys_seq>
<trans_time>20090405010104</trans_time>
<pay_type>517</pay_type>
<res_info>
<trade_no>15415906</trade_no>
<out_trade_no>1000000000511</out_trade_no>
<refund_amt>1</refund_amt>
<refund_time>20221113203144</refund_time>
</res_info>
<result>
<id>0000</id>
<comment>退款成功</comment>
</result>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 固定值:online_refund_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
pos_seq | 退款请求流水号 | String(32) | 退款请求流水号,和请求报文相同 | 必填 |
sys_seq | 随机串号 | String(16) | 随机生成串号,仅用于日志跟踪用,不保存 | 必填 |
trans_time | 接口返回时间 | String(14) | 接口返回时间,格式:yyyyMMddHHmmss | 必填 |
pay_type | 支付类型 | String(3) | 517:网银支付 518:快捷支付 | 必填 |
res_info ->trade_no | 通道支付流水号 | String(64) | 支付交易的通道唯一流水号 | 可空 |
res_info ->out_trade_no | 支付商户订单号 | String(32) | 支付交易的商户订单号 | 可空 |
res_info ->refund_amt | 退款金额 | String(9) | 单位为分 | 可空 |
res_info ->refund_time | 退款时间 | String(14) | 格式:yyyyMMddHHmmss | 可空 |
result ->id | 响应码 | String(4) | 0000:退款成功 9998:退款处理中(需要调用退款查询确认退款结果) 其它为失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!