Bulk Credit Customer Wallets
POST
https://api.zid.sa/v1/customer-wallets/customers/bulk-credit/
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 credits fail. Always check failed_count in the response to determine whether any credits 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-credit/' \
--header 'Store-Id: 123456' \
--header 'X-manager-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"customer_ids": [
987654,
987655,
987656
],
"amount": 100,
"reason": "Promotional wallet credit",
"expires_at": "2026-12-31T23:59:59Z"
}'Response Response Example
200 - Example 1
{
"succeeded": [
{
"customer_id": 987654,
"transaction_id": "txn_8d45f76a",
"error": null
},
{
"customer_id": 987654,
"transaction_id": "txn_8d45f76a",
"error": null
}
],
"failed": [
{
"customer_id": 987656,
"transaction_id": null,
"error": "Unable to credit customer wallet."
},
{
"customer_id": 987656,
"transaction_id": null,
"error": "Unable to credit customer wallet."
}
],
"total": 3,
"succeeded_count": 2,
"failed_count": 1
}Modified atΒ 2026-09-08 09:58:46