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

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Resumen de endpoints

> Un índice completo de los endpoints de la API de Yuno organizados por recurso

Esta página ofrece un catálogo fácil de explorar de todos los endpoints de la API REST de Yuno. Úsala para descubrir qué operaciones están disponibles antes de pasar a las páginas de referencia individuales.

Para detalles de implementación:

* [Autenticación](https://docs.y.uno/es/reference/getting-started/authentication.md): cómo autenticar las solicitudes a la API
* [Entornos](https://docs.y.uno/es/reference/getting-started/api-environments.md): URLs base de sandbox y producción
* [Especificación OpenAPI](https://docs.y.uno/openapi.json): definición de la API legible por máquina

> [!NOTE]
>
> Este resumen se genera a partir de la especificación OpenAPI completa (172 operaciones).
> Un subconjunto de 39 operaciones se probó en sandbox y está disponible en `openapi/yuno_sandbox_tested.json`.

## AI Caller

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/smart-support/external/payments` | Iniciar contacto de recuperación para flujos de usuario abandonados | — |
| POST | `/smart-support/external/payments/recover` | Crear recuperación | — |

## Cuentas (Banking Connectivity)

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/banking/accounts` | Crear cuenta (Banking Connectivity) | — |
| DELETE | `/banking/accounts/\{account_id\}` | Cerrar cuenta (Banking Connectivity) | — |
| GET | `/banking/accounts/\{account_id\}` | Obtener detalles de la cuenta (Banking Connectivity) | — |
| PATCH | `/banking/accounts/\{account_id\}` | Actualizar cuenta (Banking Connectivity) | — |

## Checkout Builder

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/checkouts` | Listar checkouts | — |
| POST | `/checkouts` | Crear checkout | Sí |
| GET | `/checkouts/\{checkout_code\}` | Obtener la configuración del checkout | — |
| PATCH | `/checkouts/\{checkout_code\}` | Gestionar el ciclo de vida del checkout | Sí |
| PUT | `/checkouts/\{checkout_code\}` | Publicar la configuración del checkout | Sí |

## Sesiones de checkout

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/checkout/sessions` | Crear sesión de checkout | — |
| GET | `/checkout/sessions/\{checkout_session\}` | Consultar sesión de checkout | — |
| PATCH | `/checkout/sessions/\{checkout_session\}` | Actualizar sesiones | — |
| GET | `/checkout/sessions/\{checkout_session\}/payment-methods` | Consultar métodos de pago del checkout | — |

## Campañas de comunicación

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/campaigns` | Obtener campañas | — |
| POST | `/campaigns` | Crear campañas | — |
| GET | `/campaigns/\{campaign_id\}` | Obtener campañas | — |
| PATCH | `/campaigns/\{campaign_id\}` | Actualizar campañas | — |
| POST | `/campaigns/\{campaign_id\}/rules` | Crear reglas | — |
| GET | `/campaigns/\{campaign_id\}/rules/\{rule_id\}` | Obtener reglas | — |
| PATCH | `/campaigns/\{campaign_id\}/rules/\{rule_id\}` | Actualizar reglas | — |
| PATCH | `/campaigns/\{campaign_id\}/rules/\{rule_id\}/status` | Actualizar estado | — |

## Tasa de conversión

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/currency-conversion` | Obtener tasa de conversión | — |

## Inscripción de sesiones de cliente

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/customers/sessions` | Crear sesión de cliente | — |

## Clientes

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/customers` | Consultar cliente por ID externo | — |
| POST | `/customers` | Crear cliente | — |
| DELETE | `/customers/\{customer_id\}` | Eliminar clientes | — |
| GET | `/customers/\{customer_id\}` | Consultar cliente | — |
| PATCH | `/customers/\{customer_id\}` | Actualizar cliente | — |

## Dry Run

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/dry-run/provider-events` | Registrar payloads de solicitud, respuesta y webhook del proveedor | Sí |

## Entidades (Banking Connectivity)

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/banking/entities` | Crear entidad (Banking Connectivity) | — |
| GET | `/banking/entities/\{entity_id\}` | Obtener detalles de la entidad (Banking Connectivity) | — |
| PATCH | `/banking/entities/\{entity_id\}` | Actualizar entidad (Banking Connectivity) | — |

## Onboarding de entidades (Banking Connectivity)

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/banking/entities/\{entity_id\}/onboardings` | Crear onboarding de entidad (Banking Connectivity) | — |
| GET | `/banking/entities/\{entity_id\}/onboardings/\{onboarding_id\}` | Obtener estado del onboarding de entidad (Banking Connectivity) | — |
| PATCH | `/banking/entities/\{entity_id\}/onboardings/\{onboarding_id\}` | Actualizar onboarding de entidad (Banking Connectivity) | — |
| POST | `/banking/entities/\{entity_id\}/onboardings/\{onboarding_id\}/cancel` | Cancelar onboarding de entidad (Banking Connectivity) | — |

## Transferencias de entidades (Banking Connectivity)

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/banking/accounts/\{account_id\}/transfers/\{transfer_id\}` | Obtener estado de la transferencia de entidad (Banking Connectivity) | — |
| POST | `/banking/accounts/\{account_id\}/transfers/\{transfer_id\}/cancel` | Cancelar transferencia de entidad (Banking Connectivity) | — |
| POST | `/banking/transfers` | Iniciar transferencia de entidad (Banking Connectivity) | — |

## Cuotas

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/installments-plans` | Obtener planes de cuotas | — |
| POST | `/installments-plans` | Crear plan de cuotas | — |
| DELETE | `/installments-plans/\{installment_code\}` | Eliminar plan de cuotas | — |
| GET | `/installments-plans/\{installment_code\}` | Obtener plan de cuotas por ID | — |
| PATCH | `/installments-plans/\{installment_code\}` | Actualizar plan | — |

## Network Tokens

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/network-tokens/cryptograms` | Generar criptograma de network token | — |

## Organizaciones

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/connections` | Crear una conexión | Sí |
| GET | `/connections/\{connection_id\}` | Consultar una conexión | — |
| GET | `/connections/catalog/\{provider_id\}` | Obtener catálogo del proveedor | — |
| GET | `/organizations/account-groups` | Listar grupos de cuentas | — |
| POST | `/organizations/account-groups` | Crear grupo de cuentas | — |
| DELETE | `/organizations/account-groups/\{account_group_id\}` | Eliminar grupo de cuentas | — |
| GET | `/organizations/account-groups/\{account_group_id\}` | Consultar grupo de cuentas | — |
| PATCH | `/organizations/account-groups/\{account_group_id\}` | Actualizar grupo de cuentas | — |
| GET | `/organizations/account-groups/\{account_group_id\}/accounts` | Listar cuentas del grupo | — |
| POST | `/organizations/account-groups/\{account_group_id\}/accounts` | Crear cuenta | — |
| DELETE | `/organizations/account-groups/\{account_group_id\}/accounts/\{account_id\}` | Quitar cuenta del grupo | — |
| GET | `/organizations/accounts` | Listar cuentas | — |
| DELETE | `/organizations/accounts/\{account_id\}` | Eliminar cuenta | — |
| GET | `/organizations/accounts/\{account_id\}` | Consultar cuenta | — |
| PATCH | `/organizations/accounts/\{account_id\}` | Actualizar cuenta | — |
| POST | `/organizations/authenticate` | Autenticar usuario de marca blanca | — |
| GET | `/organizations/permissions-catalog` | Listar catálogo de permisos | — |
| GET | `/organizations/roles` | Listar roles | — |
| POST | `/organizations/roles` | Crear rol | — |
| DELETE | `/organizations/roles/\{role_id\}` | Eliminar rol | — |
| PATCH | `/organizations/roles/\{role_id\}` | Actualizar rol | — |
| GET | `/organizations/users` | Listar usuarios | — |
| POST | `/organizations/users` | Crear usuario | — |
| DELETE | `/organizations/users/\{user_id\}` | Eliminar usuario | — |
| GET | `/organizations/users/\{user_id\}` | Consultar usuario | — |
| PATCH | `/organizations/users/\{user_id\}` | Actualizar usuario | — |
| GET | `/organizations/users/\{user_id\}/account-group-permissions` | Consultar permisos de grupos de cuentas del usuario | — |
| PATCH | `/organizations/users/\{user_id\}/account-group-permissions` | Actualizar permisos de grupos de cuentas del usuario | — |
| PUT | `/organizations/users/\{user_id\}/account-group-permissions` | Reemplazar permisos de grupos de cuentas del usuario | — |
| DELETE | `/organizations/users/\{user_id\}/account-group-permissions/\{account_group_id\}` | Eliminar permiso de grupo de cuentas del usuario | — |
| GET | `/organizations/users/\{user_id\}/account-permissions` | Consultar permisos de cuentas del usuario | — |
| PATCH | `/organizations/users/\{user_id\}/account-permissions` | Actualizar permisos de cuentas del usuario | — |
| PUT | `/organizations/users/\{user_id\}/account-permissions` | Reemplazar permisos de cuentas del usuario | — |
| DELETE | `/organizations/users/\{user_id\}/account-permissions/\{account_id\}` | Eliminar permiso de cuenta del usuario | — |
| GET | `/routing` | Listar enrutamientos | — |
| POST | `/routing` | Crear un enrutamiento | Sí |
| GET | `/routing/\{routing_id\}` | Consultar un enrutamiento | — |
| PATCH | `/routing/\{routing_id\}` | Actualizar un enrutamiento | Sí |
| POST | `/routing/recommendations` | Obtener una recomendación de enrutamiento | — |

## Enlaces de pago

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/payment-links` | Crear enlace de pago | — |
| GET | `/payment-links/\{code\}` | Consultar enlace de pago | — |
| POST | `/payment-links/\{code\}/cancel` | Cancelar enlace de pago | — |

## Checkout de métodos de pago

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/checkout/customers/sessions/\{customer_session\}/payment-methods` | Consultar métodos de pago para inscribir | — |
| POST | `/customers/payment-methods/\{payment_method_id\}/unenroll` | Cancelar la inscripción de un método de pago | — |
| POST | `/customers/sessions/\{customer_session\}/payment-methods` | Inscribir método de pago | — |
| GET | `/payment-methods/\{payment_method_id\}` | Consultar método de pago por ID | — |

## Flujo directo de métodos de pago

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/customers/\{customer_id\}/payment-methods` | Consultar métodos de pago inscritos | — |
| POST | `/customers/\{customer_id\}/payment-methods` | Inscribir método de pago | — |
| GET | `/customers/\{customer_id\}/payment-methods/\{payment_method_id\}` | Consultar método de pago inscrito por ID | — |
| POST | `/customers/\{customer_id\}/payment-methods/\{payment_method_id\}/unenroll` | Cancelar la inscripción de un método de pago | — |
| PATCH | `/payment-methods/\{payment_method_id\}` | Reasignar un método de pago a otro cliente | — |
| POST | `/payment-methods/account-updater` | Registrar tarjetas almacenadas para Account Updater | — |

## Pagos

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/issuers` | Consultar emisores | — |
| GET | `/payments` | Consultar pago por ID de orden del comercio | — |
| POST | `/payments` | Crear pago | Sí |
| POST | `/payments/\{id\}/transactions/\{transaction_id\}/refund` | Reembolsar pago | — |
| GET | `/payments/\{payment_id\}` | Consultar pago por ID | — |
| POST | `/payments/\{payment_id\}/cancel-or-refund` | Cancelar o reembolsar un pago | — |
| POST | `/payments/\{payment_id\}/fulfillments` | Notificar entrega | — |
| POST | `/payments/\{payment_id\}/transactions/\{transaction_id\}/cancel` | Cancelar pago | — |
| POST | `/payments/\{payment_id\}/transactions/\{transaction_id\}/cancel-or-refund` | Cancelar o reembolsar un pago con transacción | — |
| POST | `/payments/\{payment_id\}/transactions/\{transaction_id\}/capture` | Capturar autorización | — |
| PATCH | `/payments/\{payment_id\}/transactions/\{transaction_id\}/dispute` | Actualizar disputa | — |
| POST | `/payments/\{payment_id\}/transactions/\{transaction_id\}/dispute` | Disputar un contracargo | — |

## Payouts

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/payouts` | Consultar payout por referencia del comercio | — |
| POST | `/payouts` | Crear payout | — |
| GET | `/payouts/\{payout_id\}` | Consultar payout por ID | — |

## PCI Proxy

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/pci-proxy/destinations` | Listar destinos | — |
| POST | `/pci-proxy/destinations` | Registrar destino | — |
| DELETE | `/pci-proxy/destinations/\{id\}` | Eliminar destino | — |
| POST | `/pci-proxy/destinations/\{id\}/disable` | Deshabilitar destino | — |
| POST | `/pci-proxy/destinations/\{id\}/enable` | Habilitar destino | — |
| POST | `/pci-proxy/forward` | Invocar forward proxy | — |

## Planes

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/plans` | Listar planes | — |
| POST | `/plans` | Crear plan | — |
| GET | `/plans/\{plan_id\}` | Consultar plan | — |
| POST | `/plans/\{plan_id\}/status` | Cancelar plan | — |

## Notificaciones de prédébito

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/predebit-notify` | Consultar notificación de prédébito por referencia del comercio | — |
| POST | `/predebit-notify` | Crear notificación de prédébito | Sí |
| GET | `/predebit-notify/\{pre_debit_notification_id\}` | Consultar notificación de prédébito por ID | — |

## Destinatarios para marketplace

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/onboardings/\{onboarding_id\}/transfers` | Obtener transferencias | — |
| POST | `/payments/\{payment_id\}/transactions/\{transaction_id\}/split-marketplace/transfer-reversal` | Crear reversión de transferencia | Sí |
| GET | `/recipients` | Listar destinatarios | — |
| POST | `/recipients` | Crear destinatario | — |
| DELETE | `/recipients/\{recipient_id\}` | Eliminar destinatario | — |
| GET | `/recipients/\{recipient_id\}` | Obtener destinatario | — |
| PATCH | `/recipients/\{recipient_id\}` | Actualizar destinatario | — |
| POST | `/recipients/\{recipient_id\}/onboardings` | Crear onboarding | — |
| GET | `/recipients/\{recipient_id\}/onboardings/\{onboarding_id\}` | Obtener onboarding | — |
| PATCH | `/recipients/\{recipient_id\}/onboardings/\{onboarding_id\}` | Actualizar onboarding | — |
| POST | `/recipients/\{recipient_id\}/onboardings/\{onboarding_id\}/block` | Bloquear destinatario | — |
| POST | `/recipients/\{recipient_id\}/onboardings/\{onboarding_id\}/cancel` | Cancelar onboarding | — |
| POST | `/recipients/\{recipient_id\}/onboardings/\{onboarding_id\}/continue` | Continuar onboarding | — |
| POST | `/recipients/\{recipient_id\}/onboardings/\{onboarding_id\}/transfer` | Crear transferencia | Sí |
| POST | `/recipients/\{recipient_id\}/onboardings/\{onboarding_id\}/unblock` | Desbloquear destinatario | — |
| GET | `/recipients/\{recipient_id\}/transfers` | Obtener transferencias | — |
| POST | `/recipients/onboardings/reverse-transfer/\{transfer_id\}` | Crear transferencia inversa | Sí |
| GET | `/transfers/\{transfer_id\}` | Obtener transferencias | — |

## Reportes

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/reporting/transactions` | Reportar transacciones fuera de Yuno | — |

## Informes

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/reports` | Crear un informe | — |
| GET | `/reports/\{report_id\}` | Consultar un informe | — |
| GET | `/reports/\{report_id\}/download` | Descargar un informe | — |
| GET | `/reports/list` | Listar todos los informes | — |

## Vendedores

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/sellers` | Crear vendedor | — |
| DELETE | `/sellers/\{merchant_seller_id\}` | Eliminar vendedor | — |
| GET | `/sellers/\{merchant_seller_id\}` | Obtener vendedor | — |
| PUT | `/sellers/\{merchant_seller_id\}` | Actualizar vendedor | — |

## Suscripciones

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/subscriptions` | Listar suscripciones | — |
| POST | `/subscriptions` | Crear suscripción | — |
| POST | `/subscriptions/\{id\}/retry` | Reintentar suscripción | — |
| GET | `/subscriptions/\{subscription_id\}` | Consultar suscripción | — |
| PATCH | `/subscriptions/\{subscription_id\}` | Actualizar suscripción | — |
| POST | `/subscriptions/\{subscription_id\}/cancel` | Cancelar suscripción | — |
| POST | `/subscriptions/\{subscription_id\}/pause` | Pausar suscripción | — |
| GET | `/subscriptions/\{subscription_id\}/payments` | Listar pagos de la suscripción | — |
| POST | `/subscriptions/\{subscription_id\}/plan` | Cambiar el plan de la suscripción | — |
| POST | `/subscriptions/\{subscription_id\}/resume` | Reanudar suscripción | — |

## Configuraciones de 3D Secure

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/three-d-secure/setups` | Crear configuración de 3DS2 | — |

## Transferencias

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| POST | `/split-marketplace/transfers` | Crear transferencia independiente | Sí |
| GET | `/split-marketplace/transfers/\{transfer_id\}` | Obtener transferencia independiente | — |
| POST | `/split-marketplace/transfers/\{transfer_id\}/reverse` | Revertir transferencia independiente | Sí |

## Webhooks

| Método | Endpoint | Descripción | Idempotente |
| - | - | - | - |
| GET | `/webhooks` | Listar webhooks | — |
| POST | `/webhooks` | Crear un webhook | — |
| DELETE | `/webhooks/\{webhook_id\}` | Eliminar un webhook | — |
| GET | `/webhooks/\{webhook_id\}` | Consultar un webhook | — |
| PATCH | `/webhooks/\{webhook_id\}` | Actualizar un webhook | — |


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