---
title: "Start a card purchase of a PM bundle"
method: POST
path: "/economy/checkout-session"
tags: ["Economy"]
---

# Start a card purchase of a PM bundle

`POST /economy/checkout-session`

## Request

- Base URL: `https://kellian.app/api/v1`
- URL: `https://kellian.app/api/v1/economy/checkout-session`
- Auth: one of:
  - API key in cookie `developer_auth`
  - API key in header `x-developer-auth`

## Request body

- ConsumerEconomyCheckoutSessionBody
  - `usd` integer, required
  - `usdCents` integer
  - `returnTo` 'shop' | 'balance'
  - `analytics` object
    - `clientId` string, required
    - `sessionId` string, required
    - `anonId` string, required
    - `consentVersion` 'analytics-bar-v1', required
    - `consentChoice` 'accepted' | 'not_required', required

## Response `200`

Success

- ConsumerEconomyCheckoutSessionResponse
  - `url` string, required
  - `sessionId` string, required

## Other responses

- `400`: Error: one of PURCHASE_NOT_A_BUNDLE
- `401`: Error: one of WALLET_AUTH_REQUIRED
- `403`: Error: one of SERVICE_UNAVAILABLE_IN_REGION
- `429`: Error: one of PURCHASE_CAP_EXCEEDED
- `503`: Error: one of SERVICE_UNAVAILABLE
- `default`: Error response (RFC 9457 Problem Details for HTTP APIs)

---

[API](https://skmtc.dev/problee/apis/kellian-consumer-api.md) · [All operations](https://skmtc.dev/problee/apis/kellian-consumer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/problee/apis/kellian-consumer-api/revisions/2b8254b0ec57?raw)