Kakaclo Api Docs
  • Welcome!
  • Quick Start
  • Release Notes
    • 2023-08 Add API token refresh function, logistics channel to add Express
    • 2023-07 product api increase supplierLevel info
    • 2023-06 Order Automatic Split interface changes
    • 2023-04 Product CountryAndWarehouse interface changes
    • 2023-04 Order V1 Version And Order V2 Version
    • 2022-12 Order V2 Version
  • API Usage
    • API Endpoint
    • Rate Limits
  • Admin API
    • Product
      • Category
      • Products
      • CountryAndWarehouse
      • Stock
      • Product API pull suggestion
    • Order V1(Outdated)
      • Logistics Channel
      • Order
      • Query Order
        • Orders Status Json Response
      • Refund Order
      • Query ReFund
    • Order V2
      • Logistics Channel
      • Order
      • Query Order
        • Orders Status Json Response
      • Refund Order
      • Query ReFund
      • Automatic Split Logistics Channel
    • Custom Product
      • Get Design Category Name List
      • Get Design Model List
      • Get Design Model Detail
      • Get Custom Designed List
      • Get Custom Designed Detail
      • Create designed product orders and get order list
      • Get KakaClo pod-designer address
      • Save POD Designed Product
    • Payment
      • Query Balance
Powered by GitBook
On this page
  • Request Body Parameter
  • Examples
  • Refund some items
  • Refund the entire order
  1. Admin API
  2. Order V2

Refund Order

Create a refund order

PreviousOrders Status Json ResponseNextQuery ReFund

Last updated 1 year ago

Create a refund order。

Cancel the order and get a refund. you can only do this when the order has not been shipped. This operation is performed asynchronously, and you can get the latest status information through ""

The refund status can be updated for a maximum of 24 hours. Generally, the status will be updated within 1 hour.

Request Body Parameter

Name
Type
Description

itemId

String

Item Id

skuCode

String

Sku code

quantity

Int

Refund sku number

remark

String

Refund remark

countryCode

String

Country code, the country code of the actual delivery warehouse of the sku, 'CN' for the Chinese warehouse, and 'US' for the overseas warehouse. This value comes from the Query Order API.

refundReason

String

Refund reason, the default value is 'Other', other values include 'Don't Want Anymore', 'Product Selection Error/Multiple Selection', 'Incorrect Address Information', 'Out Of Stock', 'Out Of Stock'.

POST /openapi/v2/order/orders/{id}/refund

{
    "code":10000,
    "message":"kk.api.200",
    "data":
        "111"
}

Examples

Refund some items

curl -d '{"remark":"test","refundReason":"Other","orderItems":[{"itemId":"120001","skuCode":"FSZW08923_R_L_NUB","quantity":1,"countryCode":"CN"},{"itemId":"120002","skuCode":"FSZW08923_R_L_NUB","quantity":2,"countryCode":"US"}]}' \
-X POST "https://test-developer.kakaclo.com/openapi/openapi/v2/order/orders/10001/refund" \
-H "Authorization: Bearer {YOU_ACCES_TOKEN}" \
-H "Content-Type: application/json"
HTTP/1.1 200 ok
{
    "code": 10000,
    "message": "ok",
    "data":10002
}

Refund the entire order

curl -d '{"remark":"other reason"}' \
-X POST "https://test-developer.kakaclo.com/openapi/openapi/v2/order/orders/10001/refund" \
-H "Authorization: Bearer {YOU_ACCES_TOKEN}" \
-H "Content-Type: application/json"
HTTP/1.1 200 ok
{
    "code": 10000,
    "message": "ok",
    "data":10002
}

Query ReFund