- Autenticación: cómo autenticar las solicitudes a la API
- Entornos: URLs base de sandbox y producción
- Especificación OpenAPI: definición de la API legible por máquina
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 | — |