> ## 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.

# Crear sesión de pago

> Inicie una sesión de pago para actualizar o cambiar su plan.

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

Para un plan mensual de pago, solicita un pago alojado a un proveedor disponible utilizando el país de facturación registrado. Los planes de negocio basados en el uso pueden, en cambio, devolver `activated: true` sin un pago alojado; aún pueden incurrir en cargos por uso.

El personal debe aprobar el país de facturación antes de que se habiliten los planes de pago o los niveles de negocio basados en el uso. Un país no aprobado devuelve HTTP `409` con `code: BILLING_COUNTRY_REVIEW_REQUIRED`. Complete primero la revisión del país en la página de facturación con sesión iniciada.

Envíe un proveedor desde la `visible_providers` de la cuenta. Un parámetro de URL no puede cambiar el país de facturación. Las suscripciones personales pagas existentes deben gestionarse antes de iniciar otra compra. Flutterwave rechaza el pago mensual si falta su plan de pago recurrente.

Un enlace de pago no es prueba de pago. Actualice la suscripción después de la confirmación del proveedor.

## Respuesta

**checkout\_url** `string`

La URL de la página de pago alojada. Redirija al usuario a esta URL para completar el pago.


## OpenAPI

````yaml es/mint-openapi.yaml POST /v1/billing/checkout
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks es una infraestructura de verificación universal para documentos,
    credenciales y activos digitales.

    Esta especificación define la API canónica para interactuar con los
    servicios de Truthlocks.


    ## URLs Base

    - **Producción**: `https://api.truthlocks.com`

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


    ## Autenticación

    - **Claves API**: Use el encabezado `X-API-Key` para operaciones máquina a
    máquina

    - **Tokens Bearer**: Use `Authorization: Bearer <jwt>` para operaciones
    iniciadas por el usuario


    ## Identidad del Inquilino

    En producción, la identidad del inquilino se deriva del contexto autenticado
    (clave API o JWT).

    El encabezado `X-Tenant-ID` se ignora en producción para evitar la
    suplantación de identidad.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: API de producción
  - url: https://sandbox-api.truthlocks.com
    description: Entorno Sandbox
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gestión de claves y tokens de API
  - name: Issuers
    description: Registro del emisor y gestión de la confianza
  - name: Keys
    description: Gestión de claves criptográficas para emisores
  - name: Attestations
    description: Ciclo de vida de la atestación (acuñar, revocar, reemplazar)
  - name: Verification
    description: Verificación de atestación y paquetes de prueba
  - name: Governance
    description: Flujos de trabajo de gobernanza del emisor (solo administrador)
  - name: Identity
    description: Gestión de organización, usuarios y roles
  - name: Audit
    description: Consultas de eventos de auditoría
  - name: Tenant Console
    description: Puntos finales de perfil y ciclo de vida del inquilino
  - name: Health
    description: Endpoints de estado y preparación del servicio
  - name: Risk
    description: Ingesta de señales de riesgo y detección de fraude
  - name: Risk Enforcement
    description: >-
      Acciones de aplicación de riesgos: bloqueo, desafío, cuarentena y
      configuración
  - name: Billing
    description: Gestión de facturación, suscripciones y complementos
  - name: Machine Identity
    description: >-
      Protocolo de Identidad de Agente de Máquina (MAIP) — registro de agentes,
      sesiones, confianza, testigo, cumplimiento, orquestación y observabilidad
externalDocs:
  description: API de transparencia de solo lectura (especificación de servicio separada)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/billing/checkout:
    post:
      tags:
        - Billing
      summary: Crear sesión de pago
      description: >-
        Crea una sesión de pago alojada para la actualización del plan o la
        creación de la suscripción.
      operationId: billing.checkout
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                cancel_url:
                  type: string
                  description: URL para redirigir en caso de cancelación del pago
                email:
                  type: string
                plan_key:
                  type: string
                provider:
                  type: string
                  enum:
                    - stripe
                    - flutterwave
                success_url:
                  type: string
                  description: URL para redirigir después de un pago exitoso
              type: object
              required:
                - plan_key
      responses:
        '200':
          description: Sesión de pago
          content:
            application/json:
              schema:
                type: object
                properties:
                  checkout_url:
                    type: string
                  activated:
                    type: boolean
                  plan_key:
                    type: string
                  message:
                    type: string
        '401':
          description: Autenticación requerida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '409':
          description: >-
            Se requiere una revisión del país, o primero debe gestionarse una
            suscripción personal existente.
          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: Código de error legible por máquina
          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: Mensaje de error legible por humanos
        http_status:
          type: integer
          description: Código de estado HTTP
        retry_after_ms:
          type: integer
          description: Milisegundos a esperar antes de reintentar (para límites de tasa)
        details:
          type: object
          description: Contexto de error adicional
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clave API para autenticación máquina a máquina
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT para operaciones iniciadas por el usuario

````

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