Bulk Debit Customer Wallets

POST

https://api.zid.sa/v1/customer-wallets/customers/bulk-debit/

Debits the same amount from multiple customer wallets in a single request.

🔑Scopes

third_customer_wallet_write - Customer Wallet Write

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

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 '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 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-02 10:29:07

Bulk Credit Customer Wallets

Export Customer Wallets

Bulk Debit Customer Wallets

Note#

Request

Responses

Note