Skip to content

Custom Order Statuses

To fit every business needs, We bringing more customization to the order entity such as custom order statuses, So we can set your own status based on its context to the order entity

Get statuses list

Endpoint: https://api.youcan.shop/orders/settings

Method: GET

Required Scopes

  • read-orders-statuses

Response

[200]

json
{
    "shipping": [
        {
            "slug": "shipped",
            "name": "shipped",
            "color": "#115E59FF",
            "type": "shipping"
        },
        {
            "slug": "processing",
            "name": "processing",
            "color": "#C2410CFF",
            "type": "shipping"
        },
    ],
    "payment": [
        {
            "slug": "unpaid",
            "name": "unpaid",
            "color": "#F5A623FF",
            "type": "payment"
        },
        {
            "slug": "paid",
            "name": "paid",
            "color": "#D0021BFF",
            "type": "payment"
        },
    ],
    "ordersStatus": [
        {
            "slug": "Is open",
            "name": "open",
            "color": "#4A90E2FF",
            "type": "ordersStatus"
        },
    ]
}

Update statuses list

We explicitly accept the json schema above to have a custom statuses list for all order scopes.

Endpoint: https://api.youcan.shop/orders/settings

Method: PUT

Response

[200] Status is successfully updated

json
{
    "status": 200,
    "detail": "Status is successfully updated",
    "meta": []
}