Bulk Credit Customer Wallets

POST

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

Credits multiple customer wallets with the same amount 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-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 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-02 10:28:54

List Customer Wallets

Bulk Debit Customer Wallets

Bulk Credit Customer Wallets

Note#

Request

Responses

Note