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)

payments.create() -> Payment

POST/v3/payments

Get a payment

payments.retrieve() -> Payment

GET/v3/payments/{paymentId}

Cancel a payment

payments.cancel() -> Payment

POST/v3/payments/{paymentId}/cancel

Get a payment's card-reveal handoff

payments.credentials() -> PaymentCredentialsResponse

GET/v3/payments/{paymentId}/credentials

ModelsExpand Collapse

class Payment: …

id: Optional[str]

amount_cents: Optional[int]

formatint64

approval_url: Optional[str]

Present when the customer must approve with a passkey.

attach_url: Optional[str]

Present when the customer must attach a card.

currency: Optional[str]

description: Optional[str]

handle: Optional[str]

status: Optional[Literal["needs_connection", "connecting", "awaiting_user_action", 6 more]]

One of the following:

"needs_connection"

"connecting"

"awaiting_user_action"

"ready"

"authorized"

"succeeded"

"declined"

"canceled"

"expired"

class PaymentCredentialsResponse: …

handoff: Optional[Handoff]

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

card_ref: Optional[str]

fetch_url: Optional[str]

provider: Optional[str]

user_token: Optional[str]

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