# Toku Documentation > Toku REST API Docs. Contenido propio de Toku: somos los autores y titulares, y autorizamos su reproducción literal, total o parcial. ## Guías: 👣 Primeros pasos - [Bienvenido a Toku 👋](https://docs.trytoku.com/docs/getting-started.md): ¿Qué encontrarás en esta guía? - [Glosario](https://docs.trytoku.com/docs/glosario.md): Estas son las palabras claves que te ayudarán a entender mejor esta guía - [Buenas prácticas](https://docs.trytoku.com/docs/buenas-prácticas.md): Buenas prácticas para integrarse correctamente a Toku - [Propósito y casos de uso](https://docs.trytoku.com/docs/overview-de-casos-de-uso.md): ¿Qué busca Toku y cuáles son los principales casos de uso que tiene? ## Guías: ⏩ Quick Start - [Backend](https://docs.trytoku.com/docs/backend.md) - [Data in | Información de la organización a Toku](https://docs.trytoku.com/docs/data-in-información-que-toku-requiere-para-funcionar.md): El data in es la información que Toku requiere de la organización para poder procesar sus pagos correctamente. - [Via API](https://docs.trytoku.com/docs/via-api-1.md) - [Via SFTP](https://docs.trytoku.com/docs/inscribir-medio-de-pago-automático-2.md) - [Carga Manual](https://docs.trytoku.com/docs/carga-manual.md): La forma más rápida para empezar a cobrar es cargar de manera manual en nuestro Backoffice - [Formularios en Toku: Para ejecutivos y autogestionado](https://docs.trytoku.com/docs/formularios-en-toku-para-ejecutivos-y-autogestionado-copy.md) - [Data out | Información de Toku a organización](https://docs.trytoku.com/docs/data-out.md): El data out es la información que viaja desde Toku hacia la organización. Generalmente son los pagos procesados o los medios de pagos inscritos por Toku - [Via API](https://docs.trytoku.com/docs/via-api-2.md) - [Via SFTP](https://docs.trytoku.com/docs/via-ftp.md) - [Descarga manual](https://docs.trytoku.com/docs/descarga-manual.md) - [Frontend](https://docs.trytoku.com/docs/frontend-1.md): En esta sección encontrarás la forma de interactuar con tus clientes para que puedan pagar correctamente sus deudas a través de Toku. ## Guías: 📖 Detalle de la integración - Backend: Carga tus datos a Toku y recibe notificaciones - Via API - [Subir deudas y recibir pagos](https://docs.trytoku.com/docs/recibir-pagos-instantáneos.md) - [Inscribir medio de pago automático](https://docs.trytoku.com/docs/inscribir-medio-de-pago-automático-1.md) - Via SFTP - [Subir deudas y recibir pagos](https://docs.trytoku.com/docs/construir-archivo-de-invoices-y-payments.md) - [Carga Manual](https://docs.trytoku.com/docs/carga-manual-1.md): Actualmente es la forma más rápida de cargar información a Toku mientras no estés integrado por otro medio - [Formularios en Toku: Para ejecutivos y autogestionado](https://docs.trytoku.com/docs/formulario-para-ejecutivos-y-autogestionado.md) - [Notificaciones y webhooks](https://docs.trytoku.com/docs/webhooks.md): Utiliza webhooks para obtener información de eventos en tiempo real. - Frontend: Cómo tus clientes interectuarán con tu portal de pagos - [Redirecciones: ¿Cómo redirigir a un customer a Toku o a mi organización?](https://docs.trytoku.com/docs/cómo-redirigir-a-un-customer-directamente-a-su-portal-de-pago.md) - [Iframe: ¿Cómo incrustar el portal de Toku en mi página?](https://docs.trytoku.com/docs/cómo-incrusto-el-portal-de-toku-en-mi-página.md): - - [¿Cuáles son las vistas o steps de Toku?](https://docs.trytoku.com/docs/cuáles-son-las-vistas-o-steps-de-toku.md) - [WebView: ¿Cómo usar Toku en una App mobile?](https://docs.trytoku.com/docs/cómo-usar-toku-en-una-app-mobile.md) - [Checkout Form: formulario de tarjeta embebido](https://docs.trytoku.com/docs/checkout-form.md) - [Guía de integración paso a paso](https://docs.trytoku.com/docs/checkout-form-integracion.md) ## Guías: ❓ Preguntas frecuentes - [¿Cómo comenzar sin integrarse?](https://docs.trytoku.com/docs/comenzar-sin-integrarse.md) - [¿Se puede recibir el dinero o las inscripciones de medios de pago en distintas cuentas?](https://docs.trytoku.com/docs/se-puede-recibir-el-dinero-en-distintas-cuentas.md) - [¿Cómo generar planes de pago sin fecha de término?](https://docs.trytoku.com/docs/modificar-deudas-diariamente.md) - [¿Cómo actualizar o anular una invoice en Toku?](https://docs.trytoku.com/docs/cómo-anular-un-invoice-en-toku.md) - [🇨🇱 ¿Cómo funciona el flujo de activación de transferencia?](https://docs.trytoku.com/docs/cómo-funciona-el-flujo-de-activación-de-transferencia.md) - [¿Cuáles son todos los webhooks que podría inscribir?](https://docs.trytoku.com/docs/cuales-son-todos-los-webhooks-que-permite-toku.md) - [🇲🇽 ¿Cómo funciona la validación de cuenta CLABE?](https://docs.trytoku.com/docs/cómo-funciona-la-validación-de-cuenta-clabe.md) - [¿Qué valores pueden venir en el campo gateway?](https://docs.trytoku.com/docs/qué-valores-pueden-venir-en-el-campo-gateway.md) - [¿Dónde conseguir mi API Key?](https://docs.trytoku.com/docs/dónde-conseguir-mi-api-key.md) - [🇲🇽 ¿Cómo funciona la Integración de Facturación (CFDI)?](https://docs.trytoku.com/docs/cómo-funciona-la-integración-de-facturación-cfdi.md) ## API Reference: Uso de la API - [Introducción](https://docs.trytoku.com/reference/introduccion.md): Base URL, formato de respuestas y convenciones generales. - [Autenticación](https://docs.trytoku.com/reference/autenticacion.md): API Key y OAuth M2M. - [Conexión y ambientes](https://docs.trytoku.com/reference/conexion-y-ambientes.md): IPs, puertos y sandbox. - [Headers y convenciones](https://docs.trytoku.com/reference/headers-y-convenciones.md): Headers comunes, paginación y cuentas de cobro. - [Errores y códigos de respuesta](https://docs.trytoku.com/reference/errores-y-codigos-de-respuesta.md): Estructura de errores; el detalle vive en Códigos de pago rechazado. - [Límites de tasa](https://docs.trytoku.com/reference/rate-limits.md): Qué gatilla un 429, cómo se cuenta el cupo y qué hacer al recibirlo. - [Disaster Recovery (DR)](https://docs.trytoku.com/reference/disaster-recovery.md): Qué responde la API de Toku mientras el plan de recuperación ante desastres está activo. - [Versionamiento](https://docs.trytoku.com/reference/versionamiento.md): Versionado por fecha: cómo elegir una versión con el header x-api-version y con webhook_version. ## API Reference: Recursos principales - Checkout Session - [Objeto Checkout Session](https://docs.trytoku.com/reference/checkout-session-object.md): Sesión de pago que Toku aloja para que un cliente final pague una deuda o inscriba un medio de pago automático. - [Crear Checkout Session](https://docs.trytoku.com/reference/open_checkout_session_endpoint.md): Crea una Checkout Session y devuelve su representación completa, incluida la `url` a la que se deriva al cliente final para pagar o inscribir un medio de pago. El campo `mode` fija qué hace la… - [Cobrar en un terminal POS](https://docs.trytoku.com/reference/pos_charge_endpoint.md): Cobra en un terminal POS físico y devuelve la transacción que quedó esperando a que el cliente final pase la tarjeta. **El `201` no significa que el cliente pagó**: significa que el terminal tomó la… - [Obtener Checkout Session](https://docs.trytoku.com/reference/get_checkout_session_endpoint_v2.md): Devuelve la información de una Checkout Session: su estado, los datos de facturación, la configuración de medios de pago y la `url` de pago. Se usa para consultar en qué quedó una sesión ya creada —… - [Actualizar Checkout Session](https://docs.trytoku.com/reference/public_update_checkout_session_endpoint.md): Actualiza la fecha de expiración de una Checkout Session y devuelve la sesión ya actualizada. Es la única propiedad que esta operación modifica: para cambiar los datos de facturación o la… - [Expirar Checkout Session](https://docs.trytoku.com/reference/expire_checkout_session_endpoint.md): Expira manualmente una Checkout Session y la deja en estado `EXPIRED`, de modo que ya no se pueda pagar con ella. Se usa para cerrar antes de tiempo un enlace de pago que ya no debe usarse, sin… - Customers - [Objeto Customer](https://docs.trytoku.com/reference/customer-object.md): El cliente: la persona o empresa a la que se le cobra. - [Listar Customers](https://docs.trytoku.com/reference/get_customers.md): Devuelve una lista paginada de Customers de la organización. Se usa para recorrer o buscar Customers; para obtener un Customer puntual por su identificador prefiere el endpoint de detalle. Los… - [Crear Customer](https://docs.trytoku.com/reference/create_customer.md): Crea un Customer o actualiza el existente si coincide el `external_id`. Es idempotente por `external_id` dentro de la organización: si ya existe un Customer con ese identificador externo, se… - [Buscar Customer por identificadores externos](https://docs.trytoku.com/reference/lookup_customer.md): Busca un único Customer a partir de identificadores externos. Se usa cuando no se tiene el identificador público de Toku pero sí un dato con el que se dio de alta al Customer. Debes enviar al menos… - [Listar Invoices de un Customer](https://docs.trytoku.com/reference/list_customer_invoices.md): Devuelve todas las Invoices de un Customer. Entrega las Invoices del Customer dentro de la Account seleccionada por la autenticación. Se usa para revisar el historial de cobros de un Customer… - [Obtener Customer](https://docs.trytoku.com/reference/get_customer.md): Devuelve un Customer a partir de su identificador público. Entrega todos los datos del Customer registrados en la organización. Responde `404` si el Customer no existe o no pertenece a la… - [Editar Customer](https://docs.trytoku.com/reference/edit_customer.md): Actualiza los datos de un Customer existente. Solo modifica los campos presentes en el cuerpo; los omitidos se mantienen sin cambios. Devuelve el Customer ya actualizado y responde `404` si no… - [Eliminar Customer](https://docs.trytoku.com/reference/delete_customer.md): Elimina un Customer de la organización. Elimina el Customer indicado y no devuelve contenido (`204`). Responde `404` si el Customer no existe bajo la organización autenticada. **Límite de tasa:**… - Invoices - [Objeto Invoice](https://docs.trytoku.com/reference/invoice-object.md): Deuda de un Customer: el monto que se le cobra, en qué estado de pago está y con qué datos se cobra. - [Listar Invoices](https://docs.trytoku.com/reference/list_invoices.md): Devuelve una lista paginada de Invoices de la organización. Se usa para recorrer o conciliar Invoices; para obtener una Invoice puntual por su identificador prefiere el endpoint de detalle. Los… - [Crear Invoice](https://docs.trytoku.com/reference/create_or_update_invoice.md): Crea una Invoice o actualiza la existente si coincide el identificador. Es la forma de cargar una Invoice a un Customer. Toda Invoice queda asociada a una Subscription: puedes indicarla por su… - [Listar Invoices cobrables](https://docs.trytoku.com/reference/get_paginated_chargeable_invoices.md): Devuelve las Invoices que pueden cobrarse en este momento, paginadas. Se usa para armar una corrida de cobro: entrega solo las Invoices en estado cobrable y excluye las pagadas, anuladas y no… - [Listar Invoices de un Customer](https://docs.trytoku.com/reference/list_invoices_by_customer.md): Devuelve todas las Invoices de un Customer dentro de la Account autenticada. Similar a `GET /customers/{customer_encrypted_id}/invoices`, pero acotado a la Account autenticada y responde `404`… - [Buscar Invoice por identificadores externos](https://docs.trytoku.com/reference/lookup_invoice.md): Busca una única Invoice a partir de identificadores externos. Se usa cuando no se tiene el identificador público de Toku pero sí el identificador externo con el que se cargó la Invoice. Debes enviar… - [Obtener Invoice](https://docs.trytoku.com/reference/get_invoice.md): Devuelve una Invoice a partir de su identificador público. Entrega el detalle de la Invoice, incluyendo su estado de pago y los datos de cobro. Responde `404` si la Invoice no existe o no pertenece… - [Editar Invoice](https://docs.trytoku.com/reference/edit_invoice.md): Actualiza los datos de una Invoice existente. Solo modifica los campos presentes en el cuerpo; los omitidos se mantienen sin cambios. Devuelve la Invoice ya actualizada y responde `404` si no existe… - [Eliminar Invoice](https://docs.trytoku.com/reference/delete_invoice.md): Elimina una Invoice. Elimina la Invoice indicada y no devuelve contenido (`204`). La eliminación no se puede revertir. Se usa para descartar una Invoice cargada por error; para dejar constancia de… - [Anular Invoice](https://docs.trytoku.com/reference/void_invoice.md): Anula una Invoice para dejar de cobrarla. Detiene los cobros de la Invoice y la marca como anulada. Por defecto, además la elimina; envía `delete_invoice=false` para conservarla anulada como… - Payment Methods - [Objeto Payment Method](https://docs.trytoku.com/reference/payment-method-object.md): Medio de pago de un customer: tarjeta, cuenta bancaria o Pix. - [Listar Payment Methods](https://docs.trytoku.com/reference/get_payment_methods.md): Devuelve los Payment Methods de la organización autenticada, paginados y filtrados por los query params que se envíen. Cada elemento llega en la forma agregada del Payment Method: el medio de pago,… - [Eliminar Payment Method](https://docs.trytoku.com/reference/delete_payment_method.md): Elimina un Payment Method para que deje de usarse en cobros. La eliminación es lógica: el Payment Method queda con estado `deleted` y con su fecha de eliminación, y se conserva para el historial. Si… - [Obtener Payment Method](https://docs.trytoku.com/reference/get_payment_method_by_id.md): Devuelve un Payment Method de la organización autenticada a partir de su id. Llega en la misma forma agregada que el listado: el medio de pago, su Customer, los `product_id` y las Subscriptions… - [Obtener Payment Method](https://docs.trytoku.com/reference/get_payment_method.md): **Obsoleto.** Usar `GET /payment-methods/{id}`, que entrega la misma información y acepta las versiones posteriores al 2024-05-22. Este endpoint se mantiene por compatibilidad y se va a retirar.… - [Asociar Payment Method a Subscription](https://docs.trytoku.com/reference/associate_subscription.md): Asocia una Subscription a un Payment Method para que sus cobros puedan realizarse con ese medio de pago. Quedar asociada no garantiza que se cobre con él: si la Subscription tiene más de un Payment… - [Asociar Payment Methods a Subscriptions](https://docs.trytoku.com/reference/associate_subscription_bulk.md): Asocia varias Subscriptions a Payment Methods en una sola petición. Acepta como máximo 500 pares en `data`. La respuesta es 200 incluso cuando algunos pares fallan, y trae el desglose del lote:… - México 🇲🇽 - [Inscribir cuentas CLABE por lote](https://docs.trytoku.com/reference/bulk_inscriptions_public.md): Inscribe por lote cuentas CLABE como medios de pago. Con `is_async` en `false` la respuesta llega con `200` una vez inscritas las cuentas, e incluye un resultado por cada inscripción que quedó… - Subscriptions - [Objeto Subscription](https://docs.trytoku.com/reference/subscription-object.md): Producto o servicio que la organización le presta a un Customer, y el vínculo por el que se le cobra. - [Listar Subscriptions](https://docs.trytoku.com/reference/get_subscriptions.md): Devuelve una lista paginada de Subscriptions de la Account autenticada. Se usa para recorrer o buscar Subscriptions; para obtener una Subscription puntual por su identificador prefiere el endpoint… - [Crear Subscription](https://docs.trytoku.com/reference/create_or_update_subscription.md): Crea una Subscription o actualiza la existente si coincide el identificador. Se usa para dar de alta el cobro de un producto a un Customer. Es idempotente por `(Account, product_id)`: si ya existe… - [Listar Subscriptions de un Customer](https://docs.trytoku.com/reference/subscriptions_by_customer.md): Devuelve todas las Subscriptions de un Customer. Se usa para revisar los cobros recurrentes y puntuales asociados a un Customer específico dentro de la organización autenticada. **Límite de tasa:**… - [Buscar Subscription por identificadores externos](https://docs.trytoku.com/reference/lookup_subscription.md): Busca una única Subscription a partir de identificadores externos. Se usa cuando no se tiene el identificador público de Toku pero sí el `product_id` con el que se creó la Subscription. Debes enviar… - [Obtener Subscription](https://docs.trytoku.com/reference/get_subscription.md): Devuelve una Subscription a partir de su identificador público. Entrega el detalle de la Subscription, incluyendo su configuración de recurrencia cuando corresponde. Responde `404` si la… - [Editar Subscription](https://docs.trytoku.com/reference/edit_subscription.md): Actualiza los datos de una Subscription existente. Solo modifica los campos presentes en el cuerpo; los omitidos o enviados como `null` se mantienen sin cambios. Al ajustar la configuración de… - [Eliminar Subscription](https://docs.trytoku.com/reference/delete_subscription.md): Elimina una Subscription de la organización. Elimina la Subscription indicada y no devuelve contenido (`204`). Detiene la generación de nuevas Invoices recurrentes asociadas. Responde `404` si la… - [Cambiar estado de Subscription](https://docs.trytoku.com/reference/change_subscription_status.md): Pausa o reanuda una Subscription recurrente según el estado indicado. Con `PAUSED` se pausa una Subscription activa: mientras esté pausada, la generación automática de Invoices la omite; las… - Transactions - [Objeto Transaction](https://docs.trytoku.com/reference/transaction-object.md): Intento de cobro sobre un medio de pago, con su resultado. - Autorizaciones diferidas - [Cancelar Preauthorization](https://docs.trytoku.com/reference/cancel_preauth_endpoint.md): Cancela una autorización diferida que todavía no fue capturada. Se usa para liberar el monto retenido cuando el cobro no se va a completar: el cuerpo indica la Transaction con la autorización… - [Capturar Preauthorization](https://docs.trytoku.com/reference/capture_preauth_endpoint.md): Captura una autorización diferida y cierra el cobro. Se usa para confirmar el cobro del monto retenido: el cuerpo indica la Transaction con la autorización (`transaction_reference`) y,… - Consultas - [Listar Transactions](https://docs.trytoku.com/reference/get_public_transactions.md): Lista las Transactions de la Organization autenticada según los filtros recibidos. Se usa para revisar el historial de cobros: devuelve una página de Transactions con su Customer, sus Payment… - [Obtener Transaction](https://docs.trytoku.com/reference/get_transaction.md): Devuelve una Transaction de la Organization autenticada a partir de su identificador. Se usa para consultar el detalle de un cobro puntual: la respuesta trae la Transaction con su Customer, sus… - Fees de Transactions - [Obtener Fees de una Transaction](https://docs.trytoku.com/reference/get_transaction_fees_public.md): Devuelve el fee que Toku cobró sobre una Transaction, con su desglose. Se usa para auditar cuánto cobró Toku por un pago y de dónde sale ese monto: el fee se calcula por cada Payment Intent que… - Transactions externas - [Crear Transaction externa](https://docs.trytoku.com/reference/create_external_transaction.md): Registra una Transaction externa sobre ninguno, uno o varios Invoices de una Account. Una Transaction externa registra un pago que el deudor hizo por fuera de Toku —transferencia, caja, efectivo—… - [Crear Transactions externas en lote](https://docs.trytoku.com/reference/create_external_transactions.md): Registra un lote de Transactions externas. Una Transaction externa registra un pago que el deudor hizo por fuera de Toku —transferencia, caja, efectivo— para dejar sus Invoices saldados. Se usa para… - [Eliminar Transaction externa](https://docs.trytoku.com/reference/delete_external_transaction.md): Elimina una Transaction externa y deja sus Invoices impagos. Se usa para revertir el registro de un pago hecho por fuera: además de eliminar la Transaction, los Invoices que saldaba vuelven a quedar… - [Eliminar Transactions externas en lote](https://docs.trytoku.com/reference/delete_external_transactions.md): Elimina un lote de Transactions externas y deja sus Invoices impagos. Se usa para revertir muchos registros de pagos hechos por fuera: el cuerpo lleva los identificadores en `id_transactions`, con… - [Actualizar Transaction externa](https://docs.trytoku.com/reference/update_external_transaction.md): Actualiza los datos de una Transaction externa ya registrada. Se usa para corregir la fecha del pago, el monto informado o las referencias externas de un registro. El identificador va en el… - [Actualizar Transactions externas en lote](https://docs.trytoku.com/reference/update_external_transactions.md): Actualiza un lote de Transactions externas. Se usa para corregir muchos registros en una sola llamada: cada elemento de `transactions` lleva el identificador de su Transaction y los campos a… - Webhook Endpoints - [Objeto Webhook Endpoint](https://docs.trytoku.com/reference/webhook-endpoint-object.md): Destino al que Toku entrega los webhooks. - [Listar Webhook Endpoints](https://docs.trytoku.com/reference/get_webhook_endpoints.md): Devuelve todos los webhook endpoints configurados por la organización autenticada. - [Crear Webhook Endpoint](https://docs.trytoku.com/reference/create_webhook_endpoint.md): Registra un webhook endpoint para la organización autenticada. Si ya existe un endpoint con la misma URL para la organización, se actualiza en lugar de crear uno nuevo. Devuelve el endpoint con su… - [Obtener Webhook Endpoint](https://docs.trytoku.com/reference/get_webhook_endpoint.md): Devuelve la configuración de un webhook endpoint de la organización autenticada. Incluye los eventos habilitados, el estado, la versión y los nombres de los encabezados personalizados; los valores… - [Editar Webhook Endpoint](https://docs.trytoku.com/reference/edit_webhook_endpoint.md): Actualiza la configuración de un webhook endpoint existente de la organización. Solo modifica los campos incluidos en la solicitud; el resto conserva su valor actual. Devuelve el endpoint ya… ## API Reference: Recursos secundarios - Adjustment Documents - [Registrar nota de crédito o factura de proveedor](https://docs.trytoku.com/reference/create_adjustment_document.md): Registra un documento de ajuste que la organización puede aplicar como saldo a favor al momento del cobro. Es idempotente por `(organización, external_id)`: reenviar el mismo par devuelve el… - [Actualizar documento de ajuste](https://docs.trytoku.com/reference/update_adjustment_document.md): Actualiza un documento de ajuste. `is_void` controla su disponibilidad al momento del cobro (los documentos anulados se excluyen y no pueden aplicarse como saldo a favor); `metadata` reemplaza la… - [Listar documentos de ajuste](https://docs.trytoku.com/reference/list_adjustment_documents.md): Devuelve una lista paginada de los documentos de ajuste de la organización, del más reciente al más antiguo. Se usa para recorrer o conciliar los documentos registrados, por ejemplo todos los de un… - [Obtener documento de ajuste](https://docs.trytoku.com/reference/get_adjustment_document.md): Devuelve un documento de ajuste a partir de su identificador público, incluyendo su estado: `available` si todavía se puede aplicar como saldo a favor, `used` si ya se aplicó en un pago exitoso y… - Auth - Tokens M2M - [Obtener Access Token M2M](https://docs.trytoku.com/reference/create_m2m_access_token.md): Intercambia las credenciales de un cliente máquina a máquina por un Access Token. Se usa en integraciones servidor a servidor: con el `client_id` y el `client_secret` entregados por Toku se obtiene… - Beneficiaries - [Crear Beneficiaries](https://docs.trytoku.com/reference/create_beneficiaries.md): Crea varios Beneficiaries y sus Beneficiary Accounts en una sola solicitud. Se usa para cargar de una vez el padrón de destinatarios de pago de la Organization. Cada fila se procesa por separado,… - [Listar Beneficiary Accounts de un Beneficiary](https://docs.trytoku.com/reference/get_beneficiary_accounts.md): Lista las Beneficiary Accounts asociadas a un Beneficiary, identificado por su `external_id`. Devuelve, por cada cuenta, sus datos bancarios, el estado de su verificación y el estado agregado de su… - [Actualizar metadata de un Beneficiary](https://docs.trytoku.com/reference/patch_beneficiary_metadata.md): Fusiona claves en la `metadata` de un Beneficiary sin reemplazarla por completo. Las claves enviadas se escriben sobre la metadata existente: las que ya estaban con otro valor se sobrescriben y las… - Beneficiary Accounts - [Listar verificaciones de Beneficiary Accounts por lote](https://docs.trytoku.com/reference/get_account_verifications_by_batch.md): Lista el resultado de la verificación bancaria de todas las Beneficiary Accounts cuyo Beneficiary fue creado en un mismo lote. El identificador de lote es el `id_beneficiary_batch` que devuelve la… - [Actualizar datos bancarios de Beneficiary Account](https://docs.trytoku.com/reference/patch_beneficiary_account_data.md): Reemplaza los datos bancarios de una Beneficiary Account: número de cuenta, código de banco y tipo de cuenta. La operación reemplaza el bloque completo, no fusiona campo a campo. El número y el tipo… - [Actualizar external_id de Beneficiary Account](https://docs.trytoku.com/reference/patch_beneficiary_account_external_id.md): Cambia únicamente el `external_id` de una Beneficiary Account, el identificador con que la cuenta se conoce en el sistema de origen. Se usa cuando la cuenta se creó en Toku antes de existir en el… - Consulta de consentimientos - [Consultar qué consintió una persona](https://docs.trytoku.com/reference/list_subject_consents.md): Devuelve, por cada uso de datos del que la persona tiene registro, qué versión aceptó, cuál está vigente y en qué estado queda la combinación. La organización lo llama **desde su servidor**, antes de… - Customer Collection Accounts - [Listar Customer Collection Accounts](https://docs.trytoku.com/reference/get_customer_collection_account_endpoint.md): Devuelve las Customer Collection Accounts vigentes de un Customer, es decir las cuentas bancarias con las que se le cobra por PAC o domiciliación bancaria. Cuando se envía `subscription` se… - [Crear Customer Collection Account](https://docs.trytoku.com/reference/post_customer_collection_account_endpoint.md): Registra la cuenta bancaria con la que se le cobrará a un Customer por PAC o domiciliación bancaria. Es idempotente por Customer y Subscription: si ya existe una cuenta vigente para esa combinación,… - [Eliminar Customer Collection Account](https://docs.trytoku.com/reference/delete_customer_collection_account_endpoint.md): Elimina la Customer Collection Account de un Customer para que deje de usarse en cobros. Omitir `subscription` elimina la cuenta que no está asociada a ninguna Subscription; enviarlo elimina la de… - Customer Portal - Customer Portal Sessions - [Crear Customer Portal Session](https://docs.trytoku.com/reference/create_handler.md): Crea una sesión de un Customer en el Customer Portal y devuelve la url con la que entra. Se usa para llevar a un Customer al portal desde un canal propio: la url que viene en la respuesta es el… - [Expirar Customer Portal Session](https://docs.trytoku.com/reference/expire_handler.md): Expira una Customer Portal Session para invalidar su enlace antes de la fecha prevista. Es idempotente: una sesión ya expirada se devuelve tal cual. Las Checkout Sessions abiertas que hayan nacido… - [Obtener Customer Portal Session](https://docs.trytoku.com/reference/get_handler.md): Devuelve una Customer Portal Session de la organización con su estado y su url. Se usa para saber si el enlace que se le entregó al Customer sigue vigente. Si la sesión estaba abierta y su… - [Validar Customer Portal Session](https://docs.trytoku.com/reference/validate_handler.md): Indica si una Customer Portal Session sigue sirviendo para entrar al portal. Devuelve el estado de la sesión y un `is_valid` que solo es `true` mientras la sesión está `open`. Si su… - Debt Reconciliation Public - [Revertir conciliaciones de deuda por factura](https://docs.trytoku.com/reference/undo_debt_reconciliation_by_invoice_endpoint.md): Revierte las conciliaciones de deuda (RAT) que referencian a las facturas indicadas. Se revierte toda conciliación de la organización que esté en estado `SUGGESTED`, `APPROVED` o… - Electronic Signature - [Crear Document](https://docs.trytoku.com/reference/create_document.md): Crea un Document a partir de un archivo en Base64 y devuelve la URL en la que el firmante completa la ceremonia de firma. Se usa para iniciar el flujo de firma. El archivo se envía al proveedor, el… - [Obtener URL de Document firmado](https://docs.trytoku.com/reference/get_signed_document_url.md): Devuelve la URL de descarga del Document ya firmado. Se usa una vez que el Document alcanzó el estado `signed`, que el webhook [`document.signed`](/reference/document-signed) notifica. Solo resuelve… - Forum - [Obtener Webhook Sender Configuration](https://docs.trytoku.com/reference/get_webhook_sender_organization_configuration_endpoint.md): Devuelve la pausa de envío de Webhooks vigente de una organización. Se usa para confirmar si la organización tiene el envío de Webhooks en pausa y hasta cuándo. Mientras la pausa está vigente, los… - [Actualizar Webhook Sender Configuration](https://docs.trytoku.com/reference/patch_webhook_sender_organization_configuration_endpoint.md): Cambia la fecha de término de la pausa de envío vigente de una organización. Se usa para alargar o acortar una pausa ya creada. Solo se actualiza el `expiration_datetime`; si la organización no… - [Crear Webhook Sender Configuration](https://docs.trytoku.com/reference/post_webhook_sender_organization_configuration_endpoint.md): Pausa el envío de Webhooks a Forum para una organización. Se usa para dejar de enviar Webhooks durante una ventana acotada, por ejemplo mientras Forum está en mantención. Los Webhooks que se generen… - [Expirar Webhook Sender Configuration](https://docs.trytoku.com/reference/expire_webhook_sender_organization_configuration_endpoint.md): Termina de inmediato la pausa de envío vigente de una organización. Se usa para reanudar el envío de Webhooks antes de la fecha de término previamente acordada, sin tener que calcularla. Deja el… - Intents de consentimiento - [Anunciar un consentimiento que se va a pedir](https://docs.trytoku.com/reference/create_intent.md): Registra qué se le va a pedir a quién, y devuelve el token con el que el widget lo registra. La organización llama esto **desde su servidor**, antes de renderizar el paso de su formulario. **El… - Payout - [List Payouts](https://docs.trytoku.com/reference/list_payouts.md): List payouts with pagination. **Límite de tasa:** 1000 solicitudes por hora. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa). - Payout Request Ingestion - [Ingestar Account Payables](https://docs.trytoku.com/reference/ingest_payout_request_input.md): Crea un Payout Request a partir de las Account Payables enviadas y registra las filas resultantes. Se usa para cargar cuentas por pagar desde la integración de la organización sin depender del envío… - Payout Request Items - [Listar Payout Request Items](https://docs.trytoku.com/reference/list_payout_request_items.md): Devuelve los conteos por estado y el detalle fila a fila de un Payout Request ingestado. Se usa para hacer seguimiento de una carga: `summary` entrega cuántos items quedaron en SUCCESS, FAILED y… - Receipts - Documentos tributarios - [Emitir documento tributario](https://docs.trytoku.com/reference/create_receipt.md): Emite el documento tributario que corresponde a una deuda ya pagada y lo asocia a ella. El documento se emite a través del proveedor de facturación configurado para la cuenta, según el país de la… - [Obtener documentos tributarios](https://docs.trytoku.com/reference/get_receipt.md): Devuelve los documentos tributarios ya emitidos. Admite dos formas de consulta: por `id_receipt`, que devuelve ese documento con su dirección de descarga, o por `id_transaction`, que devuelve todos… - Refunds - [Crear Refund de Invoice](https://docs.trytoku.com/reference/refund_invoice_public.md): Devuelve el dinero con que se pagó una deuda, total o parcialmente. Se usa cuando el punto de partida es la Invoice y no el pago: Toku busca el pago que la saldó y crea la devolución sobre esa… - [Obtener datos de devolución de Transaction](https://docs.trytoku.com/reference/get_transaction_data_for_refund.md): Devuelve los antecedentes que determinan si una Transaction admite devolución. Se usa antes de pedir una devolución, para saber si el gateway del pago las acepta, hasta cuándo, y cuánto del pago ya… - [Crear Refund de Transaction](https://docs.trytoku.com/reference/refund_transaction_public.md): Devuelve el dinero de un pago, total o parcialmente. Se usa para reversar un pago ya cobrado. Toku registra la devolución como una Transaction propia de tipo `REVERSED`, ligada al pago original, y… - Reports - [Generar Report](https://docs.trytoku.com/reference/generate_report.md): Genera el reporte de la entidad indicada y devuelve las URLs firmadas para descargarlo. Aplica los filtros del payload, exporta el resultado en el formato pedido (`xlsx` por defecto o `csv`) y deja… - [Listar columnas de Report](https://docs.trytoku.com/reference/get_report_columns.md): Devuelve las columnas que trae el reporte de la entidad indicada. Cada elemento entrega `field`, el nombre interno de la columna, y `label`, su nombre traducido al idioma del país de la… - Risk flow validator executions - [Create a validation and the link the customer opens](https://docs.trytoku.com/reference/create_public_validator_execution.md): Create a pending validation from the caller's own configuration and return its link. The organization's own surface, reached server-to-server with an api-key, and the only one where the caller… ## API Reference: Brasil - Boleto - Cadastro de carteira - [Cadastrar Payment Method de boleto](https://docs.trytoku.com/reference/enroll_carteira_boleto.md): Cria o Payment Method de boleto que a Subscription usará para cobrar. - Emissão - [Emitir boleto a partir de Invoices](https://docs.trytoku.com/reference/external_boleto_initialize.md): Emite um boleto para as Invoices indicadas, sem precisar informar Account nem Customer. - PDF do boleto - [Obter PDF do boleto](https://docs.trytoku.com/reference/download_pdf_for_transaction.md): Devolve em base64 o PDF dos boletos das Transactions indicadas. - [Anexar um PDF externo ao boleto](https://docs.trytoku.com/reference/upload_external_pdf.md): Armazena o PDF do boleto gerado pela sua organização e dispara a mensageria ao pagador. O arquivo é guardado no mesmo lugar do PDF gerado pela Toku, então o portal e os endpoints de download passam a… - Débito Automático - Cadastro de contas - [Cadastrar Payment Methods de Débito Automático](https://docs.trytoku.com/reference/create_bulk_automatic_debit_payment_methods.md): Cadastra, em um único lote, as contas bancárias que passarão a ser debitadas. - Pix - Chaves Pix - [Cadastrar chave Pix](https://docs.trytoku.com/reference/initialize_enrollment_pix.md): Cadastra uma chave Pix para um Customer e devolve o Payment Method resultante. - Cobranças Pix - [Criar cobrança Pix](https://docs.trytoku.com/reference/external_onetime_initialize.md): Cria uma cobrança Pix avulsa para as Invoices indicadas e devolve o QR Code e o código Copia e Cola. - Pix Automático - Cadastro - [Cadastrar Payment Method via notificação push](https://docs.trytoku.com/reference/initialize_push_notification_enrollment.md): Cadastra o Payment Method de Pix Automático e cria a recorrência no banco do pagador. - Configuração de cobrança - [Criar Pix Automatic Configuration](https://docs.trytoku.com/reference/create_pix_automatic_configuration.md): Registra a configuração de cobrança do Pix Automático de uma Subscription. - [Obter Pix Automatic Configuration](https://docs.trytoku.com/reference/get_pix_automatic_configuration.md): Devolve a configuração de cobrança do Pix Automático de uma Subscription. - [Excluir Pix Automatic Configuration](https://docs.trytoku.com/reference/soft_delete_pix_automatic_configuration.md): Marca como excluída a configuração de cobrança do Pix Automático de uma Subscription. - [Atualizar Pix Automatic Configuration](https://docs.trytoku.com/reference/update_pix_automatic_configuration.md): Atualiza a configuração de cobrança do Pix Automático de uma Subscription. ## API Reference: Chile - PAC - [Crear PACs por lote](https://docs.trytoku.com/reference/create_pacs.md): Inscribe por lote los PACs enviados en el cuerpo. Cada registro se procesa por separado, así que un registro inválido no detiene al resto: la respuesta trae el recuento por resultado y, cuando hubo… - [Eliminar PACs por lote](https://docs.trytoku.com/reference/delete_pacs.md): Da de baja por lote los PACs enviados en el cuerpo. Los registros se identifican igual que al crearlos y se procesan uno por uno, de modo que una baja fallida no afecta a las demás. La respuesta usa… - POS Terminals - [Listar los terminales POS](https://docs.trytoku.com/reference/list_terminals.md): Lista los terminales POS vigentes de la cuenta de las credenciales de la petición. Los terminales eliminados no aparecen. - [Registrar un terminal POS](https://docs.trytoku.com/reference/create_terminal.md): Registra un terminal POS para la cuenta de las credenciales de la petición. El adquirente (`gateway`) queda fijo al registrarlo: los cobros que corran en ese dispositivo van a ese adquirente, sin… - [Obtener un terminal POS](https://docs.trytoku.com/reference/get_terminal.md): Obtiene un terminal POS de la cuenta de las credenciales de la petición. Un terminal de otra cuenta responde 404, igual que uno que no existe. - [Actualizar un terminal POS](https://docs.trytoku.com/reference/update_terminal.md): Actualiza los datos de un terminal POS de la cuenta de las credenciales de la petición. El cuerpo reemplaza por completo a los datos registrados: un campo que no se envía queda vacío. El adquirente… - [Eliminar un terminal POS](https://docs.trytoku.com/reference/delete_terminal.md): Elimina un terminal POS de la cuenta de las credenciales de la petición. El dispositivo deja de estar disponible para cobrar, y su id puede volver a registrarse después. - Transferencias - [Listar bancos disponibles para pagar por transferencia](https://docs.trytoku.com/reference/public_available_institutions.md): Lista los bancos con los que un pagador puede pagar por transferencia un monto, y con qué producto se paga en cada uno. Responde para la cuenta principal de la organización, o para la cuenta de la… ## API Reference: México - Efectivo - Referencias de pago - [Crear Referencia Pagos Referenciados](https://docs.trytoku.com/reference/create_referenced_payment_mx_reference_endpoint.md): Genera la Referencia con la que un Customer paga en BBVA. Devuelve la referencia numérica y el número de convenio CIE que el Customer informa al pagar, junto con el monto y la fecha de expiración… - [Crear Referencia](https://docs.trytoku.com/reference/public_start_create_cash_mx_reference.md): Crea una Referencia de pago en efectivo para que un Customer la pague en tienda. Se usa para cobrar en efectivo en México: devuelve la Referencia que el Customer presenta en la caja de la cadena de… - Facturación - Datos de facturación de Customers - [Crear datos de facturación de Customer](https://docs.trytoku.com/reference/create_customer_billing_data.md): Registra los datos de facturación de un Customer. Se usa para dar de alta la información fiscal con la que se emitirán sus billing documents. Devuelve los datos creados. Falla con `400` si la… - [Registrar Customers como público en general](https://docs.trytoku.com/reference/create_customer_billing_data_bulk.md): Registra en lote los datos de facturación de varios Customers (público general). Requiere al menos un Customer y respeta un límite de tamaño por petición. Devuelve un resumen con los creados y los… - [Obtener datos de facturación de Customer](https://docs.trytoku.com/reference/get_customer_billing_data.md): Devuelve los datos de facturación de un Customer por su identificador. Falla con `404` si el Customer no tiene datos de facturación en la organización. - [Actualizar datos de facturación de Customer](https://docs.trytoku.com/reference/update_customer_billing_data.md): Actualiza los datos de facturación de un Customer por su identificador. Devuelve los datos actualizados. Falla con `404` si el Customer no tiene datos de facturación. - Datos de facturación de Invoices - [Crear datos de facturación de un Invoice](https://docs.trytoku.com/reference/create_invoice_billing_data.md): Registra los datos de facturación de un Invoice. Se usa para asociar a un Invoice la información fiscal con la que se emitirá su billing document. Devuelve los datos creados. Falla con `400` por… - [Editar datos de facturación de un Invoice](https://docs.trytoku.com/reference/edit_invoice_billing_data.md): Actualiza los datos de facturación de un Invoice por su identificador. Devuelve los datos actualizados. Falla con `404` si no existen y con `400` por datos inválidos (montos, ítems o precios… - [Obtener datos de facturación de un Invoice](https://docs.trytoku.com/reference/get_invoice_billing_data.md): Devuelve los datos de facturación de un Invoice por su identificador. Falla con `404` si el Invoice o sus datos de facturación no existen en la organización. - Documentos (CFDI) - [Cancelar Billing Document](https://docs.trytoku.com/reference/cancel_billing_document.md): Cancela un billing document ante el SAT (vía Facturama) por su identificador. Devuelve el resultado de la cancelación. Falla con `404` si el billing document no existe en la organización y con `500`… - [Crear nota de crédito](https://docs.trytoku.com/reference/create_credit_note.md): Emite una nota de crédito (CFDI de egreso) a partir de un billing document existente. Se usa para anular un billing document cuando el ejercicio fiscal ya está cerrado y no se puede cancelar… - [Crear Billing Document PPD](https://docs.trytoku.com/reference/create_ppd_billing_document.md): Emite un billing document PPD (pago en parcialidades o diferido) para un Invoice. Genera el CFDI de tipo PPD ante Facturama y registra el evento de creación. La operación es idempotente por Invoice… - [Crear complemento de pago PPD](https://docs.trytoku.com/reference/create_ppd_complement_billing_document.md): Emite el complemento de pago de un billing document PPD para los Invoices de una Transaction. Genera el CFDI de complemento de pago (recepción de pagos) ante Facturama y registra el evento de… - [Crear complemento de pago PPD desde movimiento de wallet](https://docs.trytoku.com/reference/create_ppd_complement_from_wallet_movement_billing_document.md): Emite el complemento de pago de un billing document PPD a partir de un movimiento de wallet. Genera el CFDI de complemento de pago para los payment intents del movimiento de wallet indicado y… - [Crear Billing Document PUE](https://docs.trytoku.com/reference/create_pue_billing_document.md): Emite un billing document PUE (pago en una sola exhibición) para los Invoices de una Transaction. Genera el CFDI de tipo PUE ante Facturama y registra el evento de creación. La operación es… - [Listar Billing Documents](https://docs.trytoku.com/reference/get_billing_document.md): Lista los billing documents de la organización que coinciden con los filtros indicados. Devuelve los billing documents (CFDI) filtrables por los parámetros de query. Falla con `404` si no se… - Transferencias - [Obtener Cuenta CLABE de un Customer](https://docs.trytoku.com/reference/get_transfer_clabe_account.md): Devuelve la Cuenta CLABE de la moneda pedida asociada a un Customer de la organización autenticada. **Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde `429`. Ver [Límites… - [Crear Cuenta CLABE de un Customer](https://docs.trytoku.com/reference/create_transfer_clabe_account.md): Crea la Cuenta CLABE de un Customer específico. Responde con conflicto si el Customer ya tiene una cuenta asignada. **Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde… - Validación de Cuenta Clabe - [Verificar BankAccount](https://docs.trytoku.com/reference/verify_bank_account.md): Registra la verificación de titularidad de una cuenta CLABE mexicana. Se usa para confirmar que una cuenta existe y que pertenece a la persona declarada. Encola una micro transferencia SPEI hacia la… - [Listar BankAccountVerifications](https://docs.trytoku.com/reference/get_bank_account_verifications.md): Lista BankAccountVerifications aplicando filtros combinables. Permite buscar por identificadores, CLABEs, nombres del titular, RFC, referencias de lote o rango de fechas de creación; los filtros se… - [Obtener BankAccountVerification](https://docs.trytoku.com/reference/get_bank_account_verification_by_id.md): Obtiene una BankAccountVerification por su identificador público. Devuelve el resultado estructurado de la verificación: estado, validación del titular y, si ya está disponible, la información y las… - [Verificar BankAccounts en lote público](https://docs.trytoku.com/reference/verify_public_bulk_bank_accounts.md): Registra en un solo lote la verificación de varias cuentas CLABE. Se usa para verificar muchas cuentas de una vez desde la API pública. Cada elemento del lote se procesa igual que una verificación… ## API Reference: Webhooks - Activation - [activation.created](https://docs.trytoku.com/reference/activation-created.md): **Condición de disparo:** Se crea una activación de transferencia (transfer_cl) para una cuenta. - Bank Account Verification - [bank_account_verification.result](https://docs.trytoku.com/reference/bank-account-verification-result.md): **Condición de disparo:** Se obtiene el resultado de una verificación de cuenta bancaria. - Billing Document - [billing_document.created](https://docs.trytoku.com/reference/billing-document-created.md): **Condición de disparo:** Se emite un documento tributario (factura o nota) para una deuda. - Chargeback - [chargeback.status_update](https://docs.trytoku.com/reference/chargeback-status-update.md): **Condición de disparo:** Cambia el estado de un contracargo. - Checkout Session - [checkout_session.accessed](https://docs.trytoku.com/reference/checkout-session-accessed.md): **Condición de disparo:** El pagador accede a una sesión de checkout. - [checkout_session.expired](https://docs.trytoku.com/reference/checkout-session-expired.md): **Condición de disparo:** Una sesión de checkout expira. - Client Bank Movements - [client_bank_movements.bulk_created](https://docs.trytoku.com/reference/client-bank-movements-bulk-created.md): **Condición de disparo:** Se registran movimientos bancarios nuevos en una cuenta bancaria de la organización; llegan agrupados en envíos de hasta 500 movimientos. - Customer - [customer.created](https://docs.trytoku.com/reference/customer-created.md): **Condición de disparo:** Se crea un cliente. - [customer.deleted](https://docs.trytoku.com/reference/customer-deleted.md): **Condición de disparo:** Se elimina un cliente. - [customer.updated](https://docs.trytoku.com/reference/customer-updated.md): **Condición de disparo:** Se actualiza un cliente. - Debt Reconciliation - [debt_reconciliation.reconciled](https://docs.trytoku.com/reference/debt-reconciliation-reconciled.md): **Condición de disparo:** Una reconciliación de deuda pasa a estado APPROVED o MANUALLY_RECONCILED. - Document - [document.canceled](https://docs.trytoku.com/reference/document-canceled.md): **Condición de disparo:** Se cancela un documento de firma electrónica. - [document.failed](https://docs.trytoku.com/reference/document-failed.md): **Condición de disparo:** Falla la firma de un documento de firma electrónica. - [document.signed](https://docs.trytoku.com/reference/document-signed.md): **Condición de disparo:** Se firma un documento de firma electrónica. - Interaction - [interaction.incoming](https://docs.trytoku.com/reference/interaction-incoming.md): **Condición de disparo:** Se recibe una interacción entrante de un cliente (mensaje o correo). - Invoice - [invoice.created](https://docs.trytoku.com/reference/invoice-created.md): **Condición de disparo:** Se crea una deuda (invoice). - [invoice.paid](https://docs.trytoku.com/reference/invoice-paid.md): **Condición de disparo:** Se paga una deuda. - [invoice.refund](https://docs.trytoku.com/reference/invoice-refund.md): **Condición de disparo:** Se reembolsa una deuda. - [invoice.updated](https://docs.trytoku.com/reference/invoice-updated.md): **Condición de disparo:** Se actualiza una deuda. - [invoice.voided](https://docs.trytoku.com/reference/invoice-voided.md): **Condición de disparo:** Se anula una deuda. - Invoice Restructuring - [invoice_restructuring.completed](https://docs.trytoku.com/reference/invoice-restructuring-completed.md): **Condición de disparo:** Una reestructuración de facturas completa sus after-actions: se crean las nuevas facturas y se anulan las originales. - Operation Receipt - [operation_receipt.created](https://docs.trytoku.com/reference/operation-receipt-created.md): **Condición de disparo:** Se crea un comprobante de operación. - Payment Instrument - [payment_instrument.created](https://docs.trytoku.com/reference/payment-instrument-created.md): **Condición de disparo:** Se crea un instrumento de pago. - [payment_instrument.updated](https://docs.trytoku.com/reference/payment-instrument-updated.md): **Condición de disparo:** Se actualiza un instrumento de pago. - Payment Method - [payment_method.attached_products](https://docs.trytoku.com/reference/payment-method-attached-products.md): **Condición de disparo:** Se asocian productos a un medio de pago existente. - [payment_method.deleted](https://docs.trytoku.com/reference/payment-method-deleted.md): **Condición de disparo:** Se elimina un medio de pago. - [payment_method.status_update](https://docs.trytoku.com/reference/payment-method-status-update.md): **Condición de disparo:** Cambia el estado de un medio de pago. - [payment_method.updated](https://docs.trytoku.com/reference/payment-method-updated.md): **Condición de disparo:** Se actualizan los datos de un medio de pago. - Payment Method Inscription Intent - [payment_method_inscription_intent.failed](https://docs.trytoku.com/reference/payment-method-inscription-intent-failed.md): **Condición de disparo:** Falla un intento de inscripción de medio de pago. - Payout - [payout.done 🇨🇱](https://docs.trytoku.com/reference/payout-done.md): **Condición de disparo:** Se completa el payout (depósito) del dinero conciliado de una cuenta en Chile. - [payout_br.success 🇧🇷](https://docs.trytoku.com/reference/payout-br-success.md): **Condição de disparo:** O payout (depósito) de uma conta no Brasil é concluído com sucesso. - [payout_mx.success 🇲🇽](https://docs.trytoku.com/reference/payout-mx-success.md): **Condición de disparo:** Se completa con éxito el payout (depósito) de una cuenta en México. - [payout_cl.success 🇨🇱](https://docs.trytoku.com/reference/payout-cl-success.md): **Condición de disparo:** Se completa con éxito el payout (depósito) de una cuenta en Chile, con el detalle de sus transacciones. - Rendition File - [rendition_file.created](https://docs.trytoku.com/reference/rendition-file-created.md): **Condición de disparo:** Se crea un archivo de rendición. - [rendition_file.success](https://docs.trytoku.com/reference/rendition-file-success.md): **Condición de disparo:** Un archivo de rendición se procesa con éxito. - [rendition_file.uploaded](https://docs.trytoku.com/reference/rendition-file-uploaded.md): **Condición de disparo:** Se sube un archivo de rendición. - Subscription - [subscription.created](https://docs.trytoku.com/reference/subscription-created.md): **Condición de disparo:** Se crea una suscripción. - [subscription.deleted](https://docs.trytoku.com/reference/subscription-deleted.md): **Condición de disparo:** Se elimina una suscripción. - [subscription.updated](https://docs.trytoku.com/reference/subscription-updated.md): **Condición de disparo:** Se actualiza una suscripción. - Transaction - [transaction.bulk_failed](https://docs.trytoku.com/reference/transaction-bulk-failed.md): **Condición de disparo:** Un lote de transacciones falla. - [transaction.bulk_success](https://docs.trytoku.com/reference/transaction-bulk-success.md): **Condición de disparo:** Un lote de transacciones se procesa con éxito. - [transaction.capture_pending](https://docs.trytoku.com/reference/transaction-capture-pending.md): **Condición de disparo:** Una transacción queda autorizada y a la espera de captura. - [transaction.failed](https://docs.trytoku.com/reference/transaction-failed.md): **Condición de disparo:** Falla un intento de cobro de una transacción. - [transaction.refund](https://docs.trytoku.com/reference/transaction-refund.md): **Condición de disparo:** Una transacción se reembolsa (total o parcialmente). - [transaction.renewed](https://docs.trytoku.com/reference/transaction-renewed.md): **Condición de disparo:** Una transacción recurrente se renueva para un nuevo período. - [transaction.status_update](https://docs.trytoku.com/reference/transaction-status-update.md): **Condición de disparo:** Cambia el estado de una transacción. - [transaction.success](https://docs.trytoku.com/reference/transaction-success.md): **Condición de disparo:** Se autoriza/captura una transacción y queda en estado exitoso (pagada). - Transaction External - [transaction_external.success](https://docs.trytoku.com/reference/transaction-external-success.md): **Condición de disparo:** Una transacción procesada externamente se reporta como exitosa. ## API Reference: Catálogo de errores - [Códigos HTTP de respuesta](https://docs.trytoku.com/reference/codigos-http-de-respuesta.md): Los códigos de estado HTTP con los que responde la API, y qué significa recibir cada uno. - [Códigos de API](https://docs.trytoku.com/reference/codigos-de-api.md): Los códigos TKxxxxx de los endpoints de Customer, Subscription e Invoice y de la columna «Código Toku» del reporte de una carga masiva. - [Códigos de pago rechazado](https://docs.trytoku.com/reference/codigos-de-pago-rechazado.md): Todos los códigos de pago rechazado de Toku, con su gravedad. ## API Reference: PCI Compliant API - [Introducción](https://docs.trytoku.com/reference/secure-api-introduccion.md): Cuándo usar la PCI Compliant API, su base URL y la Secure API Key. - Llaves de encriptación - [Encriptación de la data](https://docs.trytoku.com/reference/secure-api-data-encryption.md): RSA 2048 y AES 256: cómo encriptar los datos de tarjeta antes de enviarlos. - [Generar una llave pública de encriptación](https://docs.trytoku.com/reference/generate_public_encryption_key.md): 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… - Tarjetas - [El objeto PaymentMethod de tipo Card](https://docs.trytoku.com/reference/secure-api-card-object.md): La tarjeta ya inscrita: bin, marca, expiración y el token con el que se cobra. - [Crear una Transaction con medio de pago Card](https://docs.trytoku.com/reference/create_card_transaction.md): Este endpoint puede ser llamado de tres formas. La primera, mandando el body sin encriptación de ningún parámetro. La segunda, mandando el body con 'card_information' encriptado. La tercera, mandando… - [Inscribir una tarjeta como medio de pago (asíncrono)](https://docs.trytoku.com/reference/enroll_card_payment_method_bulk.md): Este endpoint puede ser llamado de tres formas. La primera, mandando el body sin encriptación de ningún parámetro. La segunda, mandando el body con 'card_information' encriptado. La tercera, mandando… - [Inscribir una tarjeta como medio de pago (síncrono)](https://docs.trytoku.com/reference/enroll_card_payment_method_sync.md): Este endpoint puede ser llamado de tres formas. La primera, mandando el body sin encriptación de ningún parámetro. La segunda, mandando el body con 'card_information' encriptado. La tercera, mandando… - [Crear un PaymentMethod de tipo Card](https://docs.trytoku.com/reference/create_card_payment_method.md): Este endpoint puede ser llamado de tres formas. La primera, mandando el body sin encriptación de ningún parámetro. La segunda, mandando el body con 'card_information' encriptado. La tercera, mandando… - [Guardar una tarjeta como PaymentInstrument](https://docs.trytoku.com/reference/create_payment_instrument.md): Guarda una tarjeta en la bóveda PCI de Toku y crea el PaymentInstrument que la representa. No la cobra ni la inscribe como medio de pago. Los parámetros obligatorios son `card_information`, con al… ## Changelog - [Account presente en gets de invoice y subscription](https://docs.trytoku.com/changelog/account-presente-en-gets-de-invoice-y-subscription.md) - [Expiración de invoices](https://docs.trytoku.com/changelog/expiración-de-invoices.md) - [Checkout Sessions y versionamiento de webhooks](https://docs.trytoku.com/changelog/checkout-sessions-y-versionamiento-de-webhooks.md) - [Nuevos webhooks disponibles](https://docs.trytoku.com/changelog/nuevos-webhooks-disponibles.md) - [Webhook de respuesta validación de cuenta CLABE añadido](https://docs.trytoku.com/changelog/webhook-de-respuesta-validación-de-cuenta-clabe-añadido.md) - [Guía de activación de transferencias añadida](https://docs.trytoku.com/changelog/guía-de-activación-de-transferencias-añadida.md) - [Webhook de activación de transferencias Chile añadido](https://docs.trytoku.com/changelog/webhook-de-activación-de-transferencias-chile-añadido.md) - [Webhook de intentos de inscripción de pago añadido](https://docs.trytoku.com/changelog/webhook-de-intentos-de-inscripción-de-pago-añadido-1.md) - [Campo añadido a void invoice](https://docs.trytoku.com/changelog/campo-añadido-a-void-invoice.md) - [Actualización campos](https://docs.trytoku.com/changelog/actualización-campos.md)