Create RMA

Sandbox

https://openapi-stage-hk.orangeconnex.com/openapi

POST

/3pp/returns/v1/creation

3PP can get create RMA through this API.
When sellers need to create an RMA (Return Merchandise Authorization) order, OC allows 3PPs to complete this operation via the API.

Request

Header Params

Body Params application/json

Examples

Example 1Example 2

{
  "messageId": "{{messageId}}",
  "data": {
    "serviceType": "SKU",
    "referenceNumber": "665541",
    "returnWarehouseAreaCode": "DE",
    "carrier": "DHL",
    "trackingNumber": "TRACK12345678915",
    "buyerName": "koala",
    "buyerAddress": "addree",
    "buyerPostalCode": "65412",
    "buyerState": "de",
    "buyerCity": "city",
    "buyerCountryCode": "DE",
    "buyerEmail": "222@qq.com",
    "buyerPhone": "1112334444",
    "houseNumber": "1",
    "parcelDescription": "desc",
    "totalValue": 1200,
    "currency": "EUR",
    "packageLength": 50,
    "packageWidth": 40,
    "packageHeight": 30,
    "dimensionUnit": "cm",
    "packageWeight": 20,
    "weightUnit": "g",
    "remark": "remarl",
    "labelType": "1",
    "ebayId": "11",
    "ebayOrderId": "22",
    "outboundOrderNumber": "",
    "salesChannel": "Amazon",
    "returnSkuList": [
      {
        "skuId": "OC0000000611279",
        "skuQuantity": 1
      },
      {
        "skuId": "OC0000001218233",
        "skuQuantity": 2
      },
      {
        "skuId": "OC0000000611279",
        "skuQuantity": 2
      }
    ]
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Example 1Example 2

curl --location 'https://openapi-stage-hk.orangeconnex.com/openapi/3pp/returns/v1/creation' \
--header 'Access-Token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "messageId": "{{messageId}}",
  "data": {
    "serviceType": "SKU",
    "referenceNumber": "665541",
    "returnWarehouseAreaCode": "DE",
    "carrier": "DHL",
    "trackingNumber": "TRACK12345678915",
    "buyerName": "koala",
    "buyerAddress": "addree",
    "buyerPostalCode": "65412",
    "buyerState": "de",
    "buyerCity": "city",
    "buyerCountryCode": "DE",
    "buyerEmail": "222@qq.com",
    "buyerPhone": "1112334444",
    "houseNumber": "1",
    "parcelDescription": "desc",
    "totalValue": 1200,
    "currency": "EUR",
    "packageLength": 50,
    "packageWidth": 40,
    "packageHeight": 30,
    "dimensionUnit": "cm",
    "packageWeight": 20,
    "weightUnit": "g",
    "remark": "remarl",
    "labelType": "1",
    "ebayId": "11",
    "ebayOrderId": "22",
    "outboundOrderNumber": "",
    "salesChannel": "Amazon",
    "returnSkuList": [
      {
        "skuId": "OC0000000611279",
        "skuQuantity": 1
      },
      {
        "skuId": "OC0000001218233",
        "skuQuantity": 2
      },
      {
        "skuId": "OC0000000611279",
        "skuQuantity": 2
      }
    ]
  }
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "success": true,
    "code": 0,
    "messageId": "18563168780434",
    "message": "成功",
    "data": null,
    "errors": null
}

Modified at 2026-07-09 01:48:19

cancelVasOrder

Get Return Label