Credit Customer Wallet

POST

https://api.zid.sa/v1/customer-wallets/customers/{id}/credit/

Adds funds to a specific customer wallet.

🔑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

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/123e4567-e89b-12d3-a456-426614174000/credit/' \
--header 'Store-Id: 123456' \
--header 'X-manager-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "amount": 100,
    "reason": "Promotional wallet credit",
    "expires_at": "2026-12-31T23:59:59Z"
}'

Response Example

201 - Example 1

{
    "message": "Customer wallet credited successfully.",
    "transaction_id": "transaction_12345",
    "amount": "100.00"
}

Modified at 2026-09-02 10:29:36

Get Customer Wallet Balance

Debit Customer Wallet

Credit Customer Wallet

Note#

Request

Responses

Note