POST
Create a payment intent

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
Required range: x >= 1
currency
string
required
Required string length: 3
paymentMethodTypes
string[]
confirmationMethod
enum<string>
default:automatic
Available options:
automatic,
manual
captureMethod
enum<string>
default:automatic
Available options:
automatic,
manual
customerId
string
metadata
object

Response

Payment intent created

id
string
required
amountMinor
integer
required
currency
string
required
status
enum<string>
required
Available options:
requires_payment_method,
requires_action,
requires_capture,
processing,
succeeded,
cancelled
captureMethod
enum<string>
Available options:
automatic,
manual
amountCapturableMinor
integer
Required range: x >= 0
paymentId
string
lastError
object
metadata
object