> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkout-Sitzung erstellen

> Eine Zahlungssitzung initiieren, um Ihren Plan zu aktualisieren oder zu ändern.

```http theme={null}
POST /v1/billing/checkout
```

Für einen kostenpflichtigen Monatsplan wird ein gehosteter Checkout von einem verfügbaren Anbieter unter Verwendung des registrierten Abrechnungslandes angefordert. Nutzungsbasierte Geschäftspläne können stattdessen `activated: true` ohne gehosteten Checkout zurückgeben; sie können dennoch Nutzungsgebühren verursachen.

Mitarbeiter müssen das Abrechnungsland genehmigen, bevor kostenpflichtige Pläne oder nutzungsbasierte Geschäftsebenen aktiviert werden. Ein nicht genehmigtes Land gibt HTTP `409` mit `code: BILLING_COUNTRY_REVIEW_REQUIRED` zurück. Schließen Sie die Länderprüfung zuerst auf der angemeldeten Abrechnungsseite ab.

Senden Sie einen Anbieter aus dem `visible_providers` des Kontos. Ein URL-Parameter kann das Abrechnungsland nicht ändern. Bestehende kostenpflichtige persönliche Abonnements müssen verwaltet werden, bevor ein weiterer Checkout gestartet wird. Flutterwave lehnt den monatlichen Checkout ab, wenn der wiederkehrende Zahlungsplan fehlt.

Ein Checkout-Link ist kein Zahlungsnachweis. Aktualisieren Sie das Abonnement nach Bestätigung durch den Anbieter.

## Antwort

**checkout\_url** `string`

Die URL der gehosteten Checkout-Seite. Leiten Sie den Benutzer zu dieser URL um, um die Zahlung abzuschließen.


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/billing/checkout
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks ist eine universelle Verifizierungsinfrastruktur für Dokumente,
    Anmeldeinformationen und digitale Assets.

    Diese Spezifikation definiert die kanonische API für die Interaktion mit
    Truthlocks-Diensten.


    ## Basis-URLs

    - **Produktion**: `https://api.truthlocks.com`

    - **Sandbox**: `https://sandbox-api.truthlocks.com`


    ## Authentifizierung

    - **API-Schlüssel**: Verwenden Sie den Header `X-API-Key` für
    Machine-to-Machine-Operationen

    - **Bearer Tokens**: Verwenden Sie `Authorization: Bearer <jwt>` für
    benutzerinitiierte Operationen


    ## Mandantenidentität

    In der Produktion wird die Mandantenidentität aus dem authentifizierten
    Kontext (API-Schlüssel oder JWT) abgeleitet.

    Der Header `X-Tenant-ID` wird in der Produktion ignoriert, um Spoofing zu
    verhindern.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: Produktions-API
  - url: https://sandbox-api.truthlocks.com
    description: Sandbox-Umgebung
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: API-Schlüssel- und Token-Verwaltung
  - name: Issuers
    description: Ausstellerregistrierung und Vertrauensmanagement
  - name: Keys
    description: Kryptographische Schlüsselverwaltung für Aussteller
  - name: Attestations
    description: Bestätigungslebenszyklus (prägen, widerrufen, ersetzen)
  - name: Verification
    description: Bestätigungsverifizierung und Proof-Bundles
  - name: Governance
    description: Aussteller-Governance-Workflows (nur Admin)
  - name: Identity
    description: Organisations-, Benutzer- und Rollenverwaltung
  - name: Audit
    description: Audit-Ereignisabfragen
  - name: Tenant Console
    description: Mandantenprofil- und Lebenszyklus-Endpunkte
  - name: Health
    description: Endpunkte für Dienststatus und Bereitschaft
  - name: Risk
    description: Erfassung von Risikosignalen und Betrugserkennung
  - name: Risk Enforcement
    description: >-
      Risikodurchsetzungsmaßnahmen – Blockieren, Herausfordern, Quarantäne und
      Konfiguration
  - name: Billing
    description: Verwaltung von Abrechnung, Abonnements und Add-ons
  - name: Machine Identity
    description: >-
      Machine Agent Identity Protocol (MAIP) – Agentenregistrierung, Sitzungen,
      Vertrauen, Zeugen, Compliance, Orchestrierung und Beobachtbarkeit
externalDocs:
  description: Transparenz-API nur lesend (separate Dienstspezifikation)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/billing/checkout:
    post:
      tags:
        - Billing
      summary: Checkout-Sitzung erstellen
      description: >-
        Erstellt eine gehostete Checkout-Sitzung für Plan-Upgrades oder die
        Erstellung von Abonnements.
      operationId: billing.checkout
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                cancel_url:
                  type: string
                  description: URL zur Weiterleitung bei Stornierung des Checkouts
                email:
                  type: string
                plan_key:
                  type: string
                provider:
                  type: string
                  enum:
                    - stripe
                    - flutterwave
                success_url:
                  type: string
                  description: URL zur Weiterleitung nach erfolgreichem Checkout
              type: object
              required:
                - plan_key
      responses:
        '200':
          description: Checkout-Sitzung
          content:
            application/json:
              schema:
                type: object
                properties:
                  checkout_url:
                    type: string
                  activated:
                    type: boolean
                  plan_key:
                    type: string
                  message:
                    type: string
        '401':
          description: Authentifizierung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '409':
          description: >-
            Eine Länderprüfung ist erforderlich, oder ein bestehendes
            persönliches Abonnement muss zuerst verwaltet werden.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: BILLING_COUNTRY_REVIEW_REQUIRED
                  error:
                    type: string
      security:
        - APIKey: []
components:
  schemas:
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Maschinenlesbarer Fehlercode
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Menschenlesbare Fehlermeldung
        http_status:
          type: integer
          description: HTTP-Statuscode
        retry_after_ms:
          type: integer
          description: >-
            Millisekunden, die vor einem erneuten Versuch gewartet werden sollen
            (für Ratenbegrenzungen)
        details:
          type: object
          description: Zusätzlicher Fehlerkontext
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT für benutzerinitiierte Operationen

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.