---
title: "Initialize the Checkout iFrame"
method: POST
path: "/checkout/init"
tags: ["Checkout"]
---

# Initialize the Checkout iFrame

`POST /checkout/init`

Generates the configuration needed for the checkout iframe

## Request body

- InitCheckoutDTO
  - `payment` string, required — The payment used for the checkout process. Must be an `open` payment.

## Response `200`

OK

- CheckoutIframeConfigurationDTO
  - `supportedPaymentMethods` object, required — Payment methods available for this checkout session
    - `card` boolean, required — Whether card payments are supported
    - `paypal` boolean, required — Whether PayPal payments are supported
  - `timestamp` string, required — Configuration timestamp in ISO 8601 format
  - `tokenExID` string, required — Token exchange identifier for secure iframe initialization
  - `tokenScheme` string, required — Authentication scheme used for iframe token communication
  - `authenticationKey` string, required — HMAC authentication key for verifying iframe requests
  - `pci` boolean, required — Whether PCI-compliant tokenization mode is enabled

## Other responses

- `202` — The merchant is entitled but its environment is not provisioned yet. Provisioning has been kicked off (exactly once) and is in progress; retry the request — it succeeds once the environment is ready. Returned only for identity-token (dashboard) requests bound to a merchant, not for secret-key API calls; any such endpoint can return it while provisioning is underway.
- `400` — The request was rejected. `type` is `invalid_request_error` when the request itself is at fault — `errors` then lists every problem found, with field-attributable entries prefixed by the field’s path; `invalid_state_error` when the request was well-formed but the resource is not in a state that allows it; or `payment_error` when the payment was refused by the issuer or processor.
- `401` — No API key was supplied, or the key is not valid. `type` is `authentication_error`.
- `403` — The API key is valid but lacks the permission this operation requires. `type` is `permission_error`.
- `409` — `type` is `conflict_error`. The supplied `X-Idempotency-Key` was already used with a different request body (`code` is `idempotency_conflict`, and retrying will not help), or the resource is being modified by another in-flight request (`code` is `resource_locked`, and retrying with backoff will).
- `429` — Too many requests. The rate limit is applied per client across all operations. `type` is `rate_limit_error`.
- `500` — The request could not be completed because of an unexpected error. `type` is `api_error`.
- `504` — The request exceeded the processing time limit and was abandoned. `type` is `api_error` and `code` is `timeout` — unlike a plain 500 the request may still have taken effect, so retry with the same idempotency key rather than blindly.

---

[API](https://skmtc.dev/odus/apis/odus-orchestration-api.md) · [All operations](https://skmtc.dev/odus/apis/odus-orchestration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/odus/odus-orchestration-api/revisions/d5fdcba31576/schema)