klisten-co-kr Checkout API

The Checkout API from klisten-co-kr — 5 operation(s) for checkout.

Operations 5

GET /v1/checkout/config Get checkout config #
POST /v1/checkout/topups Create checkout topup #
GET /v1/checkout/topups/{id} Get checkout topup #
GET /v1/checkout/topups/{id}/approval Get checkout approval #
POST /v1/checkout/topups/{id}/capture Capture checkout topup #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/klisten-co-kr:klisten-co-kr-checkout-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

klisten-co-kr-checkout-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Klisten Agent Infrastructure Checkout API
  version: 0.1.0
  description: Phase 1 API. Optional capabilities fail closed unless their runtime dependencies are configured. See health and capability discovery for this instance.
tags:
- name: Checkout
paths:
  /v1/checkout/config:
    get:
      operationId: getCheckoutConfig
      description: Read public PayPal client ID and fixed topup packages after Google authentication and membership verification. Requires exact configured Origin. No query parameters. Sandbox never funds live balances.
      security:
      - SupabaseHuman: []
      x-implementation-status: configured-account-access
      parameters:
      - name: Origin
        in: header
        required: true
        description: Must equal the configured site_url origin. Account mutations reject missing or different origins.
        schema:
          type: string
          format: uri
      responses:
        '200':
          description: Environment-specific checkout settings; no server secrets.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutConfig'
        '400':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Checkout
      summary: Get checkout config
      x-summary-source: derived
  /v1/checkout/topups:
    post:
      operationId: createCheckoutTopup
      description: Reserve one organization-bound topup and create an order at most once. Only a fixed package identifier is accepted. Reuse the original Idempotency-Key after ambiguous responses; do not create another topup. Requires exact configured Origin.
      security:
      - SupabaseHuman: []
      x-implementation-status: configured-account-access
      parameters:
      - name: Origin
        in: header
        required: true
        description: Must equal the configured site_url origin. Account mutations reject missing or different origins.
        schema:
          type: string
          format: uri
      - name: Idempotency-Key
        in: header
        required: true
        schema:
          type: string
          minLength: 16
          maxLength: 128
          pattern: ^[A-Za-z0-9_-]+$
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckoutCreate'
      responses:
        '200':
          description: Current order state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutTopup'
        '202':
          description: Creation pending or held for reconciliation; no credit implied.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutTopup'
        '400':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Checkout
      summary: Create checkout topup
      x-summary-source: derived
  /v1/checkout/topups/{id}:
    get:
      operationId: getCheckoutTopup
      description: Reconcile the caller’s persisted topup from provider evidence without initiating capture. Requires exact configured Origin and no query parameters.
      security:
      - SupabaseHuman: []
      x-implementation-status: configured-account-access
      parameters:
      - name: Origin
        in: header
        required: true
        description: Must equal the configured site_url origin. Account mutations reject missing or different origins.
        schema:
          type: string
          format: uri
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Current durable topup state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutTopup'
        '400':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Checkout
      summary: Get checkout topup
      x-summary-source: derived
  /v1/checkout/topups/{id}/approval:
    get:
      operationId: getCheckoutApproval
      description: Read a fresh provider-verified approval URL for an existing owner-bound order. Does not create or capture payment.
      security:
      - SupabaseHuman: []
      x-implementation-status: configured-account-access
      parameters:
      - name: Origin
        in: header
        required: true
        description: Must equal the configured site_url origin. Account mutations reject missing or different origins.
        schema:
          type: string
          format: uri
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Verified provider approval URL.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutApproval'
        '400':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Checkout
      summary: Get checkout approval
      x-summary-source: derived
  /v1/checkout/topups/{id}/capture:
    post:
      operationId: captureCheckoutTopup
      description: Claim capture durably and verify PayPal payment before a single ledger grant. Approval alone never credits funds. Send an empty JSON object; no query parameters.
      security:
      - SupabaseHuman: []
      x-implementation-status: configured-account-access
      parameters:
      - name: Origin
        in: header
        required: true
        description: Must equal the configured site_url origin. Account mutations reject missing or different origins.
        schema:
          type: string
          format: uri
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckoutEmpty'
      responses:
        '200':
          description: Current durable topup state; sandbox cannot fund live balances.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutTopup'
        '202':
          description: Capture pending or held; reconciliation required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutTopup'
        '400':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Request denied or dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Checkout
      summary: Capture checkout topup
      x-summary-source: derived
components:
  schemas:
    CheckoutCreate:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties:
        package_id:
          type: string
          enum:
          - usd-5-v1
          - usd-10-v1
          - usd-25-v1
      required:
      - package_id
      additionalProperties: false
    Error:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
              pattern: ^req_[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
            retryable:
              type: boolean
          required:
          - code
          - message
          - request_id
          - retryable
          additionalProperties: false
      required:
      - error
      additionalProperties: false
    CheckoutConfig:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties:
        purchase_enabled:
          type: boolean
        purchase_disabled_reason:
          type:
          - string
          - 'null'
        provider:
          type: string
          const: paypal
        environment:
          type: string
          enum:
          - sandbox
          - live
        client_id:
          type: string
          minLength: 1
        packages:
          type: array
          items:
            type: object
            properties:
              package_id:
                type: string
                enum:
                - usd-5-v1
                - usd-10-v1
                - usd-25-v1
              currency:
                type: string
                const: USD
              amount_cents:
                type: integer
                exclusiveMinimum: 0
                maximum: 9007199254740991
            required:
            - package_id
            - currency
            - amount_cents
            additionalProperties: false
      required:
      - purchase_enabled
      - purchase_disabled_reason
      - provider
      - environment
      - client_id
      - packages
      additionalProperties: false
    CheckoutApproval:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties:
        order_id:
          type: string
        approval_url:
          type: string
          format: uri
      required:
      - order_id
      - approval_url
      additionalProperties: false
    CheckoutEmpty:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties: {}
      additionalProperties: false
    CheckoutTopup:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties:
        id:
          type: string
          format: uuid
          pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        status:
          type: string
          enum:
          - create_pending
          - order_created
          - capture_pending
          - held
          - settled_sandbox
          - credited
          - adverse
        order_id:
          type:
          - string
          - 'null'
        environment:
          type: string
          enum:
          - sandbox
          - live
        currency:
          type: string
          const: USD
        amount_cents:
          type: integer
          exclusiveMinimum: 0
          maximum: 9007199254740991
        credited_micro_usd:
          type: string
          pattern: ^(?:0|[1-9][0-9]{0,14}|[1-8][0-9]{15}|900[0-6][0-9]{12}|90070[0-9]{11}|90071[0-8][0-9]{10}|900719[0-8][0-9]{9}|9007199[0-1][0-9]{8}|90071992[0-4][0-9]{7}|900719925[0-3][0-9]{6}|9007199254[0-6][0-9]{5}|90071992547[0-3][0-9]{4}|9007199254740[0-8][0-9]{2}|90071992547409[0-8][0-9]{1}|9007199254740990[0-9]{0}|9007199254740991)$
          description: Nonnegative integer micro-USD, at most 9007199254740991. One USD is 1000000 micro-USD.
      required:
      - id
      - status
      - order_id
      - environment
      - currency
      - amount_cents
      - credited_micro_usd
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: ck_live_<secret>
    SupabaseHuman:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Supabase access token for a verified Google user in the configured project. Agent API keys are not accepted.