Skip to main content
POST
Create a payment method from a vault token

Authorizations

Authorization
string
header
required

Secret, platform or publishable API key. Platform keys require Payments-Account.

Headers

payments-account
string
payments-version
enum<string>
Available options:
2026-11-01
idempotency-key
string
required
Required string length: 1 - 255

Body

application/json
type
enum<string>
required
Available options:
card
vault_token
string
required
Required string length: 1 - 255

Response

Payment method; never the card number.

card
object | null
required
created_at
string<date-time>
required
customer
string | null
required
Pattern: ^cus_[a-f0-9]{12}$
id
string
required
Pattern: ^inst_[a-f0-9]{12}$
is_default
boolean
required
object
enum<string>
required
Available options:
payment_method
status
enum<string>
required
Available options:
active,
inactive
stored_credential
object | null
required
type
enum<string>
required
Available options:
card,
apple_pay,
google_pay
wallet
object | null
required