Create a payout account

POST

/v1/fiat-transfers/payout-accounts

Registers a fiat payout account for a user. Once created, the account can be used as the destination for fiat withdrawals.

IBAN and BIC values are validated against standard banking formats. Make sure the values you submit correspond to a real, active bank account.

Request

Authorization

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Success Response (Created)

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

curl --location 'https://test.whitelabel.bitpanda.com/v1/fiat-transfers/payout-accounts' \
--header 'bp-user-id: 12312312-2be6-4522-977e-ea4d92c45e86' \
--header 'Content-Type: application/json' \
--data '{
    "bic": "BNPAFRPPXXX",
    "bank_name": "BNP Paribas",
    "iban": "DE89370400440532013000",
    "fiat_id": "4fbc982a-d8f3-431a-8f14-3ed5d8f23312"
}'

Response Example

201 - Example 1

{
    "data": {
        "id": "1ee9f3e7-74f6-69d4-ab33-f11031b04ebc"
    }
}

Modified at 2026-07-21 14:05:14

Initiate a fiat deposit

Get payout accounts