Create Refund Orders

Request

Method: POST
Endpoint: /orders/refund
Content-Type: application/json

Request Body

Field Name	Required	Type	Description
`customer`	Yes	`object`	An object containing the customer's details as per the Customer Details table.
`products`	Yes	`array` of `objects`	An array of product objects, each structured as per the Product Details table.
`type`	Yes	`string`	The type of order, must be `"REFUND"`.
`notes`	No	`string`	Any additional notes or special instructions for the order.
`refundedAmount`	Yes	`number`	The total amount to be refunded (in EGP).
`handlesShipping`	Yes	`string`	Who handles shipping, `"CUSTOMER"` or `"BRAND"`.

Customer Details

Field Name	Required	Type	Description
`name`	Yes	`string`	The customer's full name (min 2 characters).
`phone`	Yes	`string`	Phone number starting with `01`, digits only, exactly 11 digits.
`address`	Yes	`string`	The customer's full address (min 2 characters).
`governorate`	Yes	`string`	The customer's governorate, one of the Valid Governorate Syntaxes.

Valid Governorate Syntaxes

6th of October
Alexandria
Aswan
Asyut
Beheira
Beni Suef
Cairo
Dakahlia
Damietta
Fayed
Fayoum
Gharbeya
Giza
Helwan
Ismailia
Kafr El Sheikh
Luxor
Matrouh
Menoufia
Minya
New Valley
North Sinai
Port Said
Qalyubia
Qena
Red Sea
Sharkeya
Sohag
South Sinai
Suez

Product Details

Please make sure all products provided to this route have their SKUs mapped with their Turuq counterparts.

Field Name	Required	Type	Description
`UID`	Yes	`string`	Turuq's unique 13-digit identifier for the product (digits only).
`quantity`	Yes	`number`	Quantity of the product (min 1).
`price`	Yes	`number`	Price per unit (in EGP).
`weight`	Yes	`number`	Weight per unit (in KG).
`defectiveQuantity`	No	`integer`	Number of defective units among the returned quantity. Must be a non-negative integer. Cannot exceed `quantity`.

Example Payload

{
  "customer": {
    "name": "Omar Hassan",
    "phone": "01009876543",
    "address": "45 Tahrir St., Downtown",
    "governorate": "Cairo"
  },
  "products": [
    {
      "UID": "0001112223334",
      "quantity": 2,
      "price": 500.00,
      "weight": 0.2,
      "defectiveQuantity": 1
    }
  ],
  "type": "REFUND",
  "notes": "Refund due to product defect.",
  "refundedAmount": 1000.00,
  "handlesShipping": "CUSTOMER"
}

Response

✅ 201 Created

The refund order was successfully created.

Response Body

{
  "OID": "3004720098765"
}

❌ 400 Bad Request

Invalid request, schema validation failed, client not found, or creation failure.

Example Error (Validation)

{
  "error": "Provided order doesn't satisfy the order schema",
  "issues": [ /* array of validation issue objects */ ]
}

Create Refund Orders

On this page