Create a new transaction

Create a new transaction for a user. This endpoint allows partners to initiate a transaction on behalf of a user, such as a withdrawal. The request must include the user's full name, date of birth, and the amount to be processed. Once the transaction is created, the user will be redirected to Bitpanda Pay to complete the transaction.

SecuritybearerAuth
Request
Request Body schema: application/json
amount
required
string <double> [ 10 .. 10000 ]

The amount of fiat currency to be processed in the transaction.

fiat_id
required
string <uuid>

Unique identifier for the fiat currency to be used in the transaction.

full_name
required
string

Full name of the user in "FirstName LastName" format.

date_of_birth
required
string <date>

The date of birth of the user in ISO 8601 format (YYYY-MM-DD).

type
required
string

The type of transaction being created. Currently, only "withdrawal" is supported.

Value: "withdrawal"
partner_redirect_url
required
string <uri> ^https://

A URL to redirect the user back to the partner's application.

Responses
201

Transaction created successfully

400

Bad Request (fiat below threshold)

401

Unauthorized

403

Forbidden

404

Fiat not found

422

Validation error

500

Internal Server Error

post/pay/v1/transactions
Request samples
application/json
{
  • "amount": "100.00",
  • "fiat_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  • "full_name": "John Doe",
  • "date_of_birth": "1990-05-10",
  • "type": "withdrawal",
  • "partner_redirect_url": "https://partner.domain.com"
}
Response samples
application/json
{}