1688 Create refund return application

请求参数

Header 参数

access-key

string

必需

默认值:

58c0201dfdf148eca63cbf6bb5e7cf03

nonce-str

string

可选

默认值:

nonce-str

timestamp

string

必需

默认值:

1715669977082

user-id

string

必需

默认值:

2100007341207

signature

string

必需

默认值:

B7F83FE2ADC8D8F044F2E01F0FFE8C80

Body 参数application/json

orderId

integer

必需

orderEntryIds

array[integer]

子订单id

必需

disputeRequest

string

必需

退款/退款退货。只有已收到货，才可以选择退款退货。退款:"refund"; 退款退货:"returnRefund

applyPayment

integer

必需

退款金额（单位：分）。不大于实际付款金额；等待卖家发货时，必须为商品的实际付款金额。不包含运费。

applyCarriage

integer

必需

退运费金额（单位：分）。

applyReasonId

integer

必需

退款原因id（从API getRefundReasonList获取）

description

string

必需

退款申请理由，2-150字

goodsStatus

string

必需

货物状态。售中等待卖家发货:"refundWaitSellerSend"; 售中等待买家收货:"refundWaitBuyerReceive"; 售中已收货（未确认完成交易）:"refundBuyerReceived" 售后未收货:"aftersaleBuyerNotReceived"; 售后已收到货:"aftersaleBuyerReceived

vouchers

array[string] | null

可选

退运费金额（单位：分）。

orderEntryCountList

array[object (OrderEntryCount[]) {2}] | null

可选

子订单退款数量。仅在售中买家已收货（退款退货）时，可指定退货数量；默认，全部退货。

id

integer | null

子订单id

可选

count

integer | null

子订单购买商品数量

可选

示例

{
  "orderId": 0,
  "orderEntryIds": [
    0
  ],
  "disputeRequest": "string",
  "applyPayment": 0,
  "applyCarriage": 0,
  "applyReasonId": 0,
  "description": "string",
  "goodsStatus": "string",
  "vouchers": [
    "string"
  ],
  "orderEntryCountList": [
    {
      "id": 0,
      "count": 0
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v2/alibaba/refund/detail/create' \
--header 'access-key;' \
--header 'nonce-str: nonce-str' \
--header 'timestamp;' \
--header 'user-id;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderId": 0,
    "orderEntryIds": [
        0
    ],
    "disputeRequest": "string",
    "applyPayment": 0,
    "applyCarriage": 0,
    "applyReasonId": 0,
    "description": "string",
    "goodsStatus": "string",
    "vouchers": [
        "string"
    ],
    "orderEntryCountList": [
        {
            "id": 0,
            "count": 0
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

requestId

string

请求ID

可选

code

integer

返回码

可选

developId

integer

开发者ID

可选

msg

string

返回码对应信息

可选

data

object (AlibabaRefundCreateVO)

返回内容

可选

refundId

string | null

创建成功，退款id

可选

示例

{
  "requestId": "",
  "code": 0,
  "developId": 0,
  "msg": "",
  "data": {
    "refundId": ""
  }
}