Initiate a fiat deposit

POST

/v1/fiat-transfers/deposits

Initiates a fiat deposit for a user and returns a payment_link that the user must be redirected to in order to complete the payment.

Once the payment flow is completed, the user is redirected back to the partner using one of the URLs provided in redirection_urls. Status changes throughout the lifecycle of the deposit are notified asynchronously through the Fiat Transfer Update webhook.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Success Response (Created)

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409Parameter Error

🟠422Parameter Error

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

curl --location 'https://test.whitelabel.bitpanda.com/v1/fiat-transfers/deposits' \
--header 'bp-user-id: 12312312-2be6-4522-977e-ea4d92c45e86' \
--header 'Accept-Language: de' \
--header 'Idempotency-Key: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "amount": "100.50",
    "fiat_id": "4fbc982a-d8f3-431a-8f14-3ed5d8f23312",
    "redirection_urls": {
        "success": "https://partner.example.com/deposit/success",
        "fail": "https://partner.example.com/deposit/fail"
    }
}'

Response Example

201 - Example 1

{
    "data": {
        "id": "1ee9f3e7-74f6-69d4-ab33-f11031b04ebc",
        "payment_link": "https://payments.bitpanda.com/checkout/abc123",
        "amount": "100.50",
        "fee": "1",
        "status": "initiated"
    }
}

Modified at 2026-07-31 08:13:39

Create a savings plan V2

Create a payout account