> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recital.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Debit Wallet

> Debit a wallet account.

Note: This only debits the value on the Recital Wallet and DOES NOT call the provider.

<ParamField body="amount" type="number">
  The amount to be debited from the wallet account.
</ParamField>

<ParamField body="reference" type="string">
  A unique identifier for the funding transaction.
</ParamField>

<ParamField body="description" type="string">
  A short description or note for the transaction (e.g., "Wallet settlement").
</ParamField>

<ParamField body="currency" type="string">
  The currency to debit.
</ParamField>

<RequestExample>
  ```bash Example Request theme={null}
  curl --location 'https://api.recital.finance/api/wallets/account/accountWalletId/debit' \
  --header 'Authorization: Bearer apiKey' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "amount": 100,
    "reference": "a",
    "currency": "NGN",
    "description": "test"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "reference": "TX-B5IKLCA3ZVKMAEVG",
    "link": "https://checkout-v2.dev-flutterwave.com/v3/hosted/pay/5b7a4f9b9047265",
    "status": "success",
    "message": "Hosted Link"
  }
  ```

  ```json Invalid amount Response theme={null}
  {
    "message": "Invalid amount or missing parameters",
    "success": false
  }
  ```

  ```json Invalid API key Response theme={null}
  {
    "message": "Invalid or missing API key",
    "success": false
  }
  ```

  ```json Unable to generate hosted link theme={null}
  {
    "message": "Unable to generate hosted link",
    "success": false
  }
  ```
</ResponseExample>