iPos接口接入报文规范 - 支付退款交易 - 《iPos-SA支付版》

业务说明
交易请求报文
交易请求报文说明
- goods_detail 商品信息 (JSONArray)
- extend_params 扩展参数 (JSON)
  - split_info 分账信息
    - split_list 分账明细
交易返回报文
交易返回报文说明

业务说明

支持的交易类型：
4.2条码支付、4.3扫码支付、4.13jsapi支付、4.14微信小程序支付、4.21聚合动态码支付、4.22小程序支付收银台下单

接口会根据支付订单情况自动判断退款或撤销。退款交易适用于已成功的支付交易，有效期一般有几个月，不同的支付平台有所差异；撤销适用于所有状态的支付交易，但是有效期只有24小时。

交易请求报文

JSON:

{
    "request_type": "barcode_reverse_request",
    "isspid": "39493002",
    "pos_id": "8888888888",
    "store_id": "8888888888",
    "pos_seq": "2018121400000006",
    "user_id": "user01",
    "system_id": "8888",
    "memo": "订单备注",
    "barcode_reverse_request": {
        "pay_type": "502",
        "tx_amt": "1",
        "org_pos_seq": "2018121400000001",
        "goods_detail": [
            {
                "goods_id": "apple-01",
                "payment_goods_id": "20010001",
                "goods_name": "ipad",
                "quantity": 1,
                "price": 200000,
                "goods_category": "34543238",
                "body": "特价手机",
                "show_url": "http://www.alipay.com/xxx.jpg"
            },
            {
                "goods_id": "apple-02",
                "payment_goods_id": "20010002",
                "goods_name": "ipad2",
                "quantity": 1,
                "price": 200000,
                "goods_category": "34543239",
                "body": "特价手机2",
                "show_url": "http://www.alipay.com/xxx2.jpg"
            }
        ],
        "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>barcode_reverse_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>
    <memo>订单备注</memo>
    <barcode_reverse_request>
        <pay_type>502</pay_type>
        <tx_amt>10</tx_amt>
        <org_pos_seq>1511300000001</org_pos_seq>
        <goods_detail><![CDATA[商品信息(JSON)]]></goods_detail>
        <extend_params><![CDATA[扩展参数]]></extend_params>
    </barcode_reverse_request>
</business_trans>

交易请求报文说明

节点名称	中文名称	类型	说明	是否必填
sign	报文签名	String(32)	请求报文格式为JSON时必填计算签名方式请看2.1章节	可选
request_type	请求类型	String(32)	固定值：barcode_reverse_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)	由翼码提供	必填
memo	订单备注	String(128)		可空
barcode_reverse_request ->pay_type	支付类型	String(3)	502：支付宝 503：微信支付 512：银联二维码 515：微信小程序 516：数字人民币 519：会员余额支付 521：聚分期	可空
barcode_reverse_request ->tx_amt	退款金额	Number(9)	退款金额，单位为分,不支持小数点	必填
barcode_reverse_request ->org_pos_seq	支付请求流水号	String(32)	被退款的支付请求流水号，且大于12位	必填
barcode_reverse_request ->goods_detail	退款商品信息	JSONArray	需要退款的商品信息列表，详细参数见下表使用XML格式报文时，建议使用CDATA标签包裹内容	可空
barcode_reverse_request ->extend_params	扩展参数	JSON	用于扩展一些特殊的支付参数字段，详细参数见下表使用XML格式报文时，建议使用CDATA标签包裹内容	可空

goods_detail 商品信息 (JSONArray)

JSON节点	类型	说明	是否必填	范例
goods_id	String(32)	商品的编号	必填	apple-01
payment_goods_id	String(32)	支付平台商品编号	可空	20010001
goods_name	String(256)	商品名称	必填	ipad
quantity	Number(9)	商品数量	必填	1
price	Number(8)	商品单价，单位为分	必填	200000
goods_category	String(24)	商品类目仅支付宝、银联二维码时生效	可空	34543238
body	String(1000)	商品描述信息仅支付宝时生效	可空	特价手机
show_url	String(400)	商品的展示地址仅支付宝时生效	可空	http://www.alipay.com/xxx.jpg
addn_info	String(100)	附加信息仅银联二维码时生效	可空	商品图片 http://www.95516.com/xxx.jpg

goods_detail 样例：

[
    {
        "goods_id" : "apple-01",
        "payment_goods_id" : "20010001",
        "goods_name" : "ipad",
        "quantity" : 1,
        "price" : 200000,
        "goods_category" : "34543238",
        "body" : "特价手机",
        "show_url" : "http://www.alipay.com/xxx.jpg",
        "addn_info" : "商品图片 http://www.95516.com/xxx.jpg"
    },
    {
        "goods_id" : "apple-02",
        "payment_goods_id" : "20010002",
        "goods_name" : "ipad2",
        "quantity" : 1,
        "price" : 200000,
        "goods_category" : "34543239",
        "body" : "特价手机2",
        "show_url" : "http://www.alipay.com/xxx2.jpg",
        "addn_info" : "商品图片 http://www.95516.com/xxx.jpg"
    }
]

extend_params 扩展参数 (JSON)

JSON节点	类型	说明	是否必填	范例
split_info	JSON	分账信息有实时分账的交易在部分退款时，若原支付订单使用净值分账则无需传分账信息，若原支付订单使用非净值分账，则退款必须传入分账信息，否则会报错。部分支付通道不支持分账金额退回。	可空

split_info 分账信息

JSON节点	类型	说明	是否必填	范例
keep_amt	String	从分账方自留金额中退款的金额，单位为分，可传0表示不从自留中退	必填	1000
split_list	Array	分账明细	可空

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"
            }
        ]
    }
}

交易返回报文