Bulk Debit Customer Wallets
POST
https://api.zid.sa/v1/customer-wallets/customers/bulk-debit/
Note
SAR, AED, QAR, KWD, BHD, or OMR.Stores using any other currency receive the message:
Customer wallets is only available for GCC countries.Note
Customer Wallet write operations. Approval is reviewed as part of the app review process.Note
200 OK even when all customer wallet debits fail. Always check failed_count in the response to determine whether any debits failed; do not rely on the HTTP status code alone.Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.zid.sa/v1/customer-wallets/customers/bulk-debit/' \
--header 'Store-Id: 123456' \
--header 'X-manager-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"customer_ids": [
987654,
987655,
987656
],
"amount": 50,
"reason": "Manual wallet adjustment"
}'Response Response Example
200 - Example 1
{
"succeeded": [
{
"customer_id": 987654,
"transaction_id": "transaction_12345",
"error": null
},
{
"customer_id": 987654,
"transaction_id": "transaction_12345",
"error": null
}
],
"failed": [
{
"customer_id": 987656,
"transaction_id": null,
"error": "Unable to debit customer wallet."
},
{
"customer_id": 987656,
"transaction_id": null,
"error": "Unable to debit customer wallet."
}
],
"total": 3,
"succeeded_count": 2,
"failed_count": 1
}Modified atΒ 2026-09-08 10:01:30