Update wallet balance

​

Endpoint

POST /wallets/transactions

​

Description

​

Request Body

{
  "amount": 500,
  "description": "Customer payout",
  "type": "debit",
  "wallet_id": "3d2e3f3e-3b3c-4907-a4fd-e241203440d7"
}

​

Request Fields

​

Supported Transaction Types

​

Response

​

Success Response (200 OK)

{
  "data": {
    "transaction_id": "transaction_id",
    "wallet_id": "wallet_id",
    "type": "debit",
    "amount": 500,
    "balance_after": 1500,
    "created_at": "2025-07-24T10:15:30Z"
  }
}

​

Common Errors

​

Notes & Best Practices

• Ensure the wallet is active before initiating a transaction.
• Debits will fail if the wallet balance is insufficient.
• Use clear and descriptive transaction descriptions for auditing.
• Avoid using this endpoint for external payments; use dedicated payout or funding endpoints instead.

​

Common Use Cases

• Customer payouts
• Refunds
• Wallet top-ups
• Internal balance adjustments