{"templateId":"api_docs","versions":[{"version":"v4","label":"API v4 (Legacy)","link":"/merchant-api/v4/openapi/checkout-sessions/createcheckoutsession","default":false,"active":false,"folderId":"dae0c0d1"},{"version":"v5","label":"API v5 (Latest)","link":"/merchant-api/openapi/checkout-sessions/createcheckoutsession","default":true,"active":true,"folderId":"dae0c0d1"}],"sharedDataIds":{"apiDocsStore":"api-docs-merchant-api/@v5/openapi.yaml","sidebar":"sidebar-api-reference/sidebars.yaml"},"props":{"definitionId":"merchant-api/@v5/openapi.yaml","settings":{"baseUrlPath":"/merchant-api/openapi"},"disableAutoScroll":true,"seo":{"title":"Create a checkout session","description":"Merchant backends submit authoritative checkout data using an OAuth client-credentials bearer with merchant-write permission. API and OAuth access must be enabled for the merchant. Basic authentication, buyer sessions, and read-only credentials cannot issue sessions. The merchant is derived from the credential, never the request body. An identical normalized payload and merchant-scoped idempotency key return the original session and token, including concurrent retries and reordered object keys. A changed payload returns 409. The reference expires five minutes after original issuance; retries never renew it. An unexpired consumed reference retrieves the original linked checkout; it does not create another checkout or fresh buyer-login authority. Optional assertions provision a merchant-specific buyer during issuance; only the separate browser handoff establishes the buyer context. Every buyer assertion requires email OTP before payment unless the same buyer already has a valid fully authenticated Resolve session. Omitting buyer_session_mode, or sending normal or checkout_only, follows this same requirement. Successful verification establishes normal buyer access; successful checkout logs the buyer out. Limited to 60 requests per minute per merchant."},"dynamicMarkdocComponents":[],"metadata":{"subType":"openapi-operation"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.resolvepay.com","port":4000,"ipAddress":"216.73.216.190"},"lang":"default_locale","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"resolve-merchant-api"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/merchant-api/openapi/checkout-sessions/createcheckoutsession","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}