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

# Fiat Deposit Accounts

> Retrieving fiat deposit account details and verifying bank accounts for saved recipients.

Use fiat wallet routes to show incoming deposit details and confirm bank account names before saving recipient records.

| Endpoint                                    | Purpose                                        |
| ------------------------------------------- | ---------------------------------------------- |
| `GET /partner/wallets/fiat/banks`           | List supported banks                           |
| `POST /partner/wallets/fiat/verify-account` | Confirm account name before saving a recipient |
| `GET /partner/wallets/fiat/deposit-account` | Retrieve the incoming fiat deposit account     |

The deposit account is for incoming fiat deposits. Account verification is for saved recipient setup and account-name confirmation.

Production requires approved KYB before the API returns an existing NGN deposit
account, provisions a new account, or verifies recipient bank details. A
non-approved account receives `403`, including when deposit details were
provisioned previously. Development and staging skip this gate.

## List Supported Banks

Bank codes can change. Load them from the API instead of maintaining a static list in your application.

```bash theme={null}
curl https://api-staging.stabyl.com/v1/partner/wallets/fiat/banks
```

## Verify A Bank Account

Use verification before creating a fiat recipient so operators can confirm the account name they expect.

```bash theme={null}
curl https://api-staging.stabyl.com/v1/partner/wallets/fiat/verify-account \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $STABYL_API_KEY" \
  -d '{
    "bank_code": "000013",
    "account_number": "0123456789"
  }'
```

Verification confirms account details. It does not create a recipient and it does not move funds.

## Retrieve Deposit Account

```bash theme={null}
curl https://api-staging.stabyl.com/v1/partner/wallets/fiat/deposit-account \
  -H "X-Api-Key: $STABYL_API_KEY"
```

Show the returned account name, bank name, and account number exactly. Reconcile incoming credits from `GET /partner/wallets/transactions`.

## Required Headers

`GET /partner/wallets/fiat/banks` is public. Verification and deposit account reads require `X-Api-Key`; verification requires key access to recipient setup, and deposit account reads require wallet read access.

Common failures include an invalid bank code, account number mismatch, a key that is not permitted for the action, or account access that is not ready.