Initiate a bank fiat deposit

POST

/v1/fiat-transfers/bank/deposits

Initiates a bank fiat deposit for a user and returns the bank account details the user must use to complete the transfer.

The user must initiate a bank transfer to the provided IBAN, using the transaction_reference as the payment reference. This reference is required so that the incoming transfer can be matched to the initiated transaction.

Status changes throughout the lifecycle of the deposit are notified asynchronously through the Fiat Transfer Update webhook.

Request

Authorization

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Success Response (Created)

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

curl --location 'https://test.whitelabel.bitpanda.com/v1/fiat-transfers/bank/deposits' \
--header 'bp-user-id: 12312312-2be6-4522-977e-ea4d92c45e86' \
--header 'Idempotency-Key: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
--header 'Content-Type: application/json' \
--data '{
    "fiat_id": "4fbc982a-d8f3-431a-8f14-3ed5d8f23312"
}'

Response Example

201 - Example 1

{
    "data": [
        {
            "id": "1ee9f3e7-74f6-69d4-ab33-f11031b04ebc",
            "iban": "AT48 3200 0000 1234 5864",
            "bic": "BNPAFRPPXXX",
            "bank": "BNP Paribas",
            "bank_address": "Graben 21, 1010 Vienna, Austria",
            "receiver": "Bitpanda GmbH",
            "receiver_address": "Stella-Klein-Löw-Weg 17, 1020 Vienna, Austria",
            "user_reference": "6724783516",
            "transaction_reference": "BTS-DEP-0001234567"
        }
    ]
}

Modified at 2026-10-15 12:13:28

Get fiat balances

Get deposit bank details