Customer kept part of the order at the door

POST

https://numueg.app/api/v1/stores/{store_id}/orders/{order_id}/partial-acceptance

Last modified:2026-09-19 16:39:33

x-numu-scope:orders:write

Record a partial acceptance (e.g. 2 of 3 pieces kept, 1 returned).

The order ends DELIVERED (a delivery signal, not an RTO — the customer
did pay for what they kept); collected_total becomes the cash to
expect; the returned pieces are restocked line by line; COD orders
auto-mark paid for the collected amount, prepaid orders report the
refund due.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//orders//partial-acceptance' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "lines": [
        {
            "order_line_index": 0,
            "returned_quantity": 1
        }
    ],
    "reason": "string",
    "restock": true
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "order": {
            "can_be_cancelled": true,
            "created_at": "2025-01-20T14:30:00Z",
            "currency": "EGP",
            "customer_id": "550e8400-e29b-41d4-a716-446655440000",
            "discount_amount": 0,
            "fulfillment_status": "unfulfilled",
            "id": "770e8400-e29b-41d4-a716-446655440000",
            "is_paid": false,
            "item_count": 2,
            "order_number": "ORD-1001",
            "payment_method": "cod",
            "payment_status": "unpaid",
            "shipping_cost": 5000,
            "status": "pending",
            "store_id": "660e8400-e29b-41d4-a716-446655440000",
            "subtotal": 50000,
            "tax_amount": 7700,
            "total": 62700,
            "updated_at": "2025-01-20T14:30:00Z"
        },
        "returned_value_cents": 0,
        "collected_total_cents": 0,
        "refund_due_cents": 0,
        "restocked_lines": 0
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Undo a manual mark-paid (payment back to pending)

Get order timeline