Payments

Let an agent pay on a customer’s behalf with a single-use virtual card. Connect a customer once, then create a payment — a virtual card is minted scoped to that purchase and the card details are handed back for checkout.

Create a payment (agent pays on a customer's behalf)

client.payments.create(, ?): Payment { id, amount_cents, approval_url, 5 more }

POST/v3/payments

Get a payment

client.payments.retrieve(, ?): Payment { id, amount_cents, approval_url, 5 more }

GET/v3/payments/{paymentId}

Cancel a payment

client.payments.cancel(, ?): Payment { id, amount_cents, approval_url, 5 more }

POST/v3/payments/{paymentId}/cancel

Get a payment's card-reveal handoff

client.payments.credentials(, ?): PaymentCredentialsResponse { handoff }

GET/v3/payments/{paymentId}/credentials

ModelsExpand Collapse

Payment { id, amount_cents, approval_url, 5 more }

id?: string

amount_cents?: number

formatint64

approval_url?: string

Present when the customer must approve with a passkey.

attach_url?: string

Present when the customer must attach a card.

currency?: string

description?: string

handle?: string

status?: "needs_connection" | "connecting" | "awaiting_user_action" | 6 more

One of the following:

"needs_connection"

"connecting"

"awaiting_user_action"

"ready"

"authorized"

"succeeded"

"declined"

"canceled"

"expired"

PaymentCredentialsResponse { handoff }

handoff?: Handoff { card_ref, fetch_url, provider, user_token }

Fetch the card directly from the provider with these — never through Linq.

card_ref?: string

fetch_url?: string

provider?: string

user_token?: string

Short-lived bearer to fetch the card from the provider.