Toku Llaves de encriptación API

openapi: 3.2.0
info:
  description: 'La **PCI Compliant API** es el ingress de Toku habilitado para recibir **datos de tarjeta**. Es una API

    distinta de la API pública (`api.trytoku.com`): vive en su propio host, exige su propia

    credencial y está dentro del alcance PCI DSS de Toku.


    Úsala para cualquier request que transporte el número de una tarjeta, su CVV o su fecha de

    expiración. Todo lo demás — invoices, customers, subscriptions, consultas de medios de pago ya

    inscritos — sigue viviendo en la API pública.


    Las respuestas son JSON con códigos HTTP estándar. Envía siempre `Content-Type: application/json`

    y un body JSON válido.'
  title: PCI Compliant Llaves de encriptación API
  version: '1.0'
servers:
- description: Production
  url: https://secure.api.trytoku.com
security:
- ApiKeyAuth: []
tags:
- description: 'Generación de las llaves con las que encriptas los datos de tarjeta antes de enviarlos. Toku

    soporta RSA 2048 con PKCS1_OAEP y AES 256 en modo CBC.'
  name: Llaves de encriptación
paths:
  /public-encryption-keys:
    post:
      description: Endpoint para generar una llave de encriptación. Soporta tanto RSA como AES. Para RSA, se retornará la llave pública para encriptar y guardaremos la privada para desencriptar. Para AES, la llave para encriptar y desencriptar será la misma.
      operationId: generate_public_encryption_key
      parameters:
      - description: El id público de tu organización. Toku lo exige en toda llamada a la PCI Compliant API.
        in: header
        name: x-org-id
        required: true
        schema:
          type: string
      - description: Identificador con el que guardaremos la llave para desencriptar en nuestro sistema. Puede ser un customer_id o una encryption_key.
        in: query
        name: encryption_key
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                200 - AES:
                  value:
                    created_at: 1741615913
                    secret_key: unfKiNYNJp+THnamEd4pyWbsBYpa0PNy6T0q1I+l3Wc=
                200 - RSA:
                  value:
                    created_at: 1741615913
                    public_key: '-----BEGIN PUBLIC KEY-----EXAMPLE-PUBLIC-KEY-----END PUBLIC KEY-----'
              schema:
                oneOf:
                - properties:
                    created_at:
                      default: 0
                      example: 1741615913
                      type: integer
                    public_key:
                      example: '-----BEGIN PUBLIC KEY-----EXAMPLE-PUBLIC-KEY-----END PUBLIC KEY-----'
                      type: string
                  required:
                  - created_at
                  - public_key
                  title: 200 - RSA
                  type: object
                - properties:
                    created_at:
                      default: 0
                      example: 1741615913
                      type: integer
                    secret_key:
                      example: unfKiNYNJp+THnamEd4pyWbsBYpa0PNy6T0q1I+l3Wc=
                      type: string
                  required:
                  - created_at
                  - secret_key
                  title: 200 - AES
                  type: object
          description: Operación exitosa.
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: {}
              schema:
                properties: {}
                type: object
          description: 'El request es inválido: revisa el body y los parámetros enviados.'
      summary: Generar una llave pública de encriptación
      tags:
      - Llaves de encriptación
components:
  securitySchemes:
    ApiKeyAuth:
      description: 'Secure API Key de Toku. Es **distinta** de la API Key de la API pública: pídela por separado. Envíala en el header x-api-key en cada request.'
      in: header
      name: x-api-key
      type: apiKey
x-toku-api-version: '2026-10-08'
x-provenance:
  method: searched
  source: https://docs.trytoku.com/reference
  harvested: '2026-10-29'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.trytoku.com/reference/create_card_payment_method.md
  - https://docs.trytoku.com/reference/create_card_transaction.md
  - https://docs.trytoku.com/reference/create_payment_instrument.md
  - https://docs.trytoku.com/reference/enroll_card_payment_method_bulk.md
  - https://docs.trytoku.com/reference/enroll_card_payment_method_sync.md
  - https://docs.trytoku.com/reference/generate_public_encryption_key.md
  merge:
    pages: 6
    deduped: 5
    conflicts_kept_first: 0