Checkout API

Create checkout

POST /v1/checkout

Creates a checkout session, generates the first invoice, and returns the hosted payment URL.

Body (createCheckoutSchema):

Response 201:

{
  "sessionId": "uuid",
  "checkoutUrl": "https://kwit.dev/checkout/...",
  "invoice": { }
}

Errors: 400 validation, 404 if customer/product not found, 500 otherwise.

Retrieve session

GET /v1/checkout/:sessionId

Response 200 - checkout session including status (OPEN, COMPLETE, EXPIRED).

const session = await kwit.checkout.sessions.retrieve(sessionId);