Update Cashback Rule

Developing

PUT

https://api.zid.sa/v1/customer-wallets/cashback-rules/{id}/

Updates an existing cashback rule by its unique identifier.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🔴500Internal Server error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.zid.sa/v1/customer-wallets/cashback-rules/497f6eca-6276-4993-bfeb-53cbbbba6f08/' \
--header 'Store-Id: 123456' \
--header 'X-manager-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "10% cashback on orders over SAR 200",
    "minimum_order_amount": 200,
    "cashback_amount": null,
    "cashback_percentage": 10,
    "max_cashback_amount": 75,
    "expiry_days": 45,
    "sale_channels": [
        "catalog",
        "mobile_app"
    ],
    "starts_at": "2026-09-01T00:00:00Z",
    "ends_at": "2026-10-31T23:59:59Z",
    "is_active": true
}'

Response Example

200 - Example 1

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "store_id": 123456,
    "name": "10% cashback on orders over SAR 200",
    "minimum_order_amount": 200,
    "cashback_amount": null,
    "cashback_percentage": 10,
    "max_cashback_amount": "75",
    "expiry_days": 45,
    "sale_channels": [
        "catalog",
        "mobile_app"
    ],
    "starts_at": "2026-09-01T00:00:00Z",
    "ends_at": "2026-10-31T23:59:59Z",
    "is_active": true,
    "created_at": "2026-08-20T10:30:00Z",
    "updated_at": "2026-08-31T08:45:00Z"
}

Modified at 2026-08-31 08:58:27

Retrieve Cashback Rule

Delete Cashback Rule