Debit Customer Wallet

POST

https://api.zid.sa/v1/customer-wallets/customers/{customer_id}/debit/

Removes funds from a specific customer wallet.

🔑Scopes

third_customer_wallet_write - Customer Wallet Write

Note

Customer Wallet APIs are available only for stores using one of the following currencies: SAR, AED, QAR, KWD, BHD, or OMR.
Stores using any other currency receive the message: Customer wallets is only available for GCC countries.

Note

This API requires prior approval before use. Only approved use cases are allowed to access Customer Wallet write operations. Approval is reviewed as part of the app review process.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Success

application/json

Bodyapplication/json

🟠401Unauthorized

🔴500Internal Server error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.zid.sa/v1/customer-wallets/customers/987654/debit/' \
--header 'Store-Id: 123456' \
--header 'X-manager-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "amount": 50,
    "reason": "Manual wallet adjustment"
}'

Response Example

201 - Example 1

{
    "message": "Customer wallet debited successfully.",
    "transaction_id": "transaction_12345",
    "amount": "50.00"
}

Modified at 2026-09-08 09:46:31

Credit Customer Wallet

Customer Pending Cashbacks

Debit Customer Wallet

Note#

Note#

Request

Responses

Note

Note