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.

List Supported Banks

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

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.

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

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.