Skip to main content

隔日退款

接口用途

  • 用户需要退款时，可以调用此接口，支持全额或部分退款（依赖支付机构的接口）。

接口地址

  • https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/refund

action

  • refund

请求参数，中间件===>易百后台

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
originalTraceNoString是原收银机流水号传入需要退款的原交易收银机流水号
originalDateString否原交易日期传入需要退款的原交易日期，不传默认为当天格式为yyyyMMdd
refundAmountPrice是本次退款金额单位：元
acquirerString否收单机构如：citicCashpay表示中信收单，如果收单撤销是必填的
cardInfoObject<cardInfo>否卡信息卡支付类交易需要填入原交易卡信息

请求报文举例

{
    "traceNo": "9900000910001013920150201",
    "originalTraceNo": "9900000910001013820150201",
    "originalDate": "20170912",
    "refundAmount": 40.8,
    "acquirer": "citicCashpay",
    "cardInfo": {
        "cardNo": "",
        "password": "",
        "valid": "",
        "track1": "",
        "track2": "",
        "track3": "",
        "cardSn": "",
        "icData": ""
    }
}

返回参数，易百后台===>中间件

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
orderNoString是交易订单号 
transDateString是交易时间格式为：yyyyMMddHHmmss
returnCodeString是返回码00表示交易成功，其他表示失败
returnDescString是返回信息交易结果描述或错误原因
refundAmountPrice是退款成功总金额单位：元
fundChannelList<fundChannel>否资金渠道 
printDetailObject<printDetail>否打印信息如需要在收银小票上打印信息时必填
memberDetailObject<memberDetail>否会员信息返回本次交易的会员信息
voucherDetailList<voucherDetail>否优惠券信息返回本次交易的优惠券信息
cashOrderNoString否收单原交易订单号收单退款时返回
cashBankString否收单机构标识收单退款时返回
purchaseOrderList<purchaseOrder>否收单签购单信息签购单信息

返回报文举例

{
    "traceNo": "9900000910001014020150201",
    "orderNo": "171698602301",
    "cashOrderNo": "000025",
    "cashBank": "40",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "refundAmount": 40.8,
    "fundChannel": [
        {
            "channelNo": "001",
            "channelName": "用户实付现金",
            "channelAmount": "20.8"
        },
        {
            "channelNo": "002",
            "channelName": "用户积分支付",
            "channelAmount": "20"
        }
    ],
    "printDetail": {
        "cardNo64": "622562****8888",
        "bank": "中信银行",
        "paymentOrderNo": "201612315689412157458787",
        "pointSale": "20000",
        "qrCode1": "htt://www.api-location-url.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    },
    "voucherDetail": [
        {
            "voucherId": "001",
            "voucherName": "现金优惠券",
            "voucherType": "现金",
            "voucherCode": "123456789",
            "channelAmount": "20.8"
        },
        {
            "voucherId": "002",
            "voucherName": "买一赠一优惠券",
            "voucherType": "买赠",
            "voucherCode": "1232136781",
            "channelAmount": "20.8"
        }
    ]
}

支持退款的交易

  • cardPayment
  • cardRedemption
  • qrcodeSale
Back to top