Create a settlement deposit

POST

/v1/deposit

Availability of this endpoint may vary based on the settlement process agreed upon between Bitpanda and its partners.

This endpoint is designed for partners to notify us before making a bank deposit, essentially a promise for payment.
Upon receiving the notification, Bitpanda will create a pending deposit. Once the receipt of the deposit is confirmed, it will be updated to finished state.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

New transaction has been created

Bodyapplication/json

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

curl --location 'https://test.whitelabel.bitpanda.com/v1/deposit' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "fiat_symbol": "EUR",
    "reference": "1638305327-test-deposit",
    "amount": "123.45",
    "sepa_type": "instant"
}'

Response Example

201 - Example 1

{
    "data": {
        "pid": "a5caa443-831b-4b07-8db6-cb4577aca298",
        "amount": "123.12345678",
        "state": "pending",
        "type": "deposit",
        "domain": "b2b2c",
        "fiat_symbol": "EUR",
        "payment_reference": "1638305327",
        "created_at": "2022-01-21T10:51:22+01:00"
    }
}

Modified at 2026-06-03 14:26:48

List all available fiats per partner

Update the fiat stock