v3

latestOpenAPI 3.0.32026-08-0327240.5 KB

Create an agent-readable checkout handoff

Returns a Stripe Checkout URL when enough metadata is supplied. Promoted-listing checkout also accepts stripe_spt with shared_payment_granted_token. Unsupported machine-payment rails return an explicit unsupported_payment_mode error.

post/checkout

Request body

product_idstring

payment_mode'stripe_checkout' | 'stripe' | 'stripe_link' | 'link' | 'stripe_spt'

job_idstring

Required for promote-listing checkout

buyer_emailstring email

Required when payment_mode is stripe_spt

shared_payment_granted_tokenstring

Link-issued token required when payment_mode is stripe_spt

metadataobject

Response

Checkout URL or auth-required handoff