实时退款 - 易企通1.0

场景说明
退货接口，用于合单支付、带有分账标签、无分账标签的原支付订单退货退款，支持部分退款、全额退款。
退款金额规则说明：
1、原订单有分账标签：退款申请金额须小于等于原支付订单剩余可退金额，即原订单未分账的金额均可退款。
2、原订单无分账标签：退款申请金额须小于等于原支付订单剩余可退金额（部分退款情况下存在已退金额，订单剩余可退金额=原订单金额-已退款金额），且小于等于商户当日正向交易余额（正向交易金额-已退款金额）。
（1）举例1：昨日仅发生一笔正向交易金额400元（待今日结算），今日正向交易500元，第一笔退款300元可成功，第二笔退款为昨日订单的全额退款400元（大于此时“当日正向交易余额”200元），因此退款失败。
（2）举例2：昨日仅发生一笔正向交易金额400元（待今日结算），今日仅发生一笔正向交易500元，第一笔退款为昨日订单的全额退款400元可成功，第二笔退款为今日正向交易的全额退款500元（大于此时“当日正向交易余额”100元），因此退款失败。

接口流程描述
1、无需分账的原订单退款、分账前发起退款可调用该接口
2、分账当日的退款可先发起“分账撤销”后再调用本接口，退款金额需小于等于待分账金额（=清算总额-已分账金额-已退款金额），若大于则会退款失败，或可选择极速退款
3、原支付订单带分账标签的退款，同一笔订单部分退款次数不多于20次
4、合单支付后的总单退款或子单退款，也调用该接口，上送总订单号或子订单号即可
5、满足要求的退款将实时原路退回

请求参数

Body 参数application/json

示例

{
    "orgId": "ORG000000001215",
    "orgMercode": "531000013027106",
    "orgTermno": "string",
    "orgTrace": "ORG073031190202304251234200048",
    "prodCode": "string",
    "sign": "string",
    "signType": "string",
    "orgSmercode": "string",
    "orgInfo": "string",
    "sysRetCode": "00",
    "orgGpstype": "string",
    "orgLongitude": "string",
    "orgLatitude": "string",
    "orgBasestation": "string",
    "orgDeviceIp": "string",
    "bizData": {
        "oriOrgTrace": "string",
        "oriOutTrace": "string",
        "oriBizDate": "string",
        "transAmt": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "sysRetCode": "000007",
    "sysRetMsg": "原订单获取失败,稍后重试",
    "orgId": "ORG000000001136",
    "orgMerCode": "531000013010845",
    "orgTermNo": "32812114",
    "prodTrace": "",
    "orgTrace": "ORG0478520230221150236ub2yf7",
    "prodCode": "",
    "sign": "Xht9/B6/k28gZY+JDY5dYF84qHPkk7MM8wcJsvwavoQD9Dk4G78Z40vhQj3CLLDtJvVM8eLDWzPQgcMUBlL7lsuDEu+2cGNUxR7H9/oqjcjEbRWVgyXjHzCvNv1vpF5WSiLSJ1+qd4JTbNiCQ+AZAq7jwMmJRQKeHlXZKTFUiAw=",
    "signType": "SHA256withRSA",
    "bizData": {
        "tradeRetCode": "07",
        "tradeRetMsg": "原订单获取失败,稍后重试",
        "oriOrgTrace": "ORG0651620230415110635201598",
        "transAmt": "10"
    }
}