POST
Create a payment request

Authorizations

x-api-key
string
header
required

Server-side merchant API key. Never expose it in browser code.

Headers

Idempotency-Key
string

Retry-safe key for create operations.

Body

application/json
amountMinor
integer
required

Amount in the smallest currency unit

Required range: x >= 1
currency
string
default:EUR
required
Required string length: 3
paymentMethodTypes
string[]

Eligible method families to consider

reference
string
description
string
customerEmail
string<email>
redirectUrl
string<uri>
webhookUrl
string<uri>
metadata
object

Response

Payment created

id
string
required
amountMinor
integer
required
currency
string
required
status
enum<string>
required
Available options:
created,
pending,
confirmed,
partially_refunded,
refunded,
cancelled,
expired
reference
string
description
string
metadata
object
createdAt
string<date-time>
expiresAt
string<date-time>