Esta página documenta un SDK heredado. ¿Vas a iniciar una nueva integración? Usa el Yuno SDK. ¿Ya usas un SDK heredado? Sigue la guía de migración.El nuevo Yuno SDK (Web v2.x, iOS v3.x, Android v3.x, React Native v2.x) reemplaza los SDK Full, Lite, Seamless, Render, Headless y Secure Fields con una sola API en todas las plataformas. Los SDK heredados siguen siendo compatibles en paralelo durante la transición y está previsto dejarlos de usar en 2027. Contacta a tu Account Manager para planificar la migración.
- Integración del Web SDK
- iOS
- Android
1. Instala
<head> de tu HTML. Consulta Precarga el script del SDK.O inclúyelo mediante CDN:2. Inicializa y procesa el pago
3. Agrega el contenedor HTML y el botón de pago
Manejo de un pago fallido
Equivalente en el nuevo SDK: el controlador onStatus. El Web SDK puede recuperarse de un pago fallido sin recargar la página. Dos mecanismos funcionan en conjunto:-
Reintento de pago: reintento de tarjeta en línea cuando el pago devuelve
DECLINEDoERROR. En Seamless, el SDK gestiona el reintento automáticamente. En Full Checkout, Lite y Secure Fields, llamas acontinuePaymentdespués de que tu backend confirme el rechazo. Funciona con tarjetas de crédito y débito no inscritas. Consulta Reintento de pago para ver la referencia completa. -
Cambio de método de pago: llama a
updateCheckoutSession(newSession)para inyectar una nueva sesión de checkout sin desmontar el SDK. Elegir de la lista de métodos de pago ya renderizada funciona después de cambiar la sesión; un conjunto diferente de métodos de pago requiere desmontar y volver a montar el SDK, no recargar la página. Consulta updateCheckoutSession.
En un intento reintentado, el SDK no dispara
paymentResult. Entrega la sesión de checkout clonada a tu callback onLoading como { type: 'PAYMENT_RETRY', data: { newCheckoutSession } }. Registra onLoading en tu configuración de startCheckout para recibirla:Integración del backend
Tu backend debe implementar dos endpoints de API para funcionar con Yuno. El nuevo SDK usa la misma sesión de checkout: consulta Crear la sesión de checkout.
- Crear la sesión de checkout
Antes de mostrar la interfaz de pago, tu backend crea una sesión de checkout:
- Endpoint:
POST https://api-sandbox.y.uno/v1/checkout/sessions - Obligatorios (OpenAPI):
account_id,merchant_order_id,payment_description,country - Envía también:
customer_id(de Create Customer) yamount{ currency, value } - Opcionales para el SDK:
workflow(SDK_CHECKOUT|SDK_SEAMLESS|CHECKOUT),callback_url,checkout_id - Devuelve: el ID de
checkout_session(se usa en el SDK) - Referencia: API Crear sesión de checkout
- Crear el pago
En el callback del token de un solo uso (OTT), tu backend crea el pago:
- Endpoint:
POST https://api-sandbox.y.uno/v1/payments - Encabezado obligatorio:
X-Idempotency-Key(UUID único por intento), consulta Autenticación - Cuerpo obligatorio (OpenAPI):
account_id,description,country,merchant_order_id,amount,payment_method,checkout payment_method.token= token de un solo uso del callback del SDKcheckout.session= ID de la sesión de checkout del paso 1- Devuelve: el estado del pago y el campo
sdk_action_required - Referencia: API Crear pago
sdk_action_required: true o checkout.sdk_action_required: true, debes llamar al método continuePayment() del SDK para completar los métodos de pago asíncronos (autenticación 3DS, PIX, redirecciones bancarias, etc.).
Parámetros
Parámetros principales que se usan en este inicio rápido:
Referencia completa de parámetros: Flujos de pago (Web), Flujos de pago (iOS), Flujos de pago (Android).
Métodos de integración alternativos
Si necesitas más control sobre la interfaz de usuario o sobre flujos de pago específicos, Yuno ofrece métodos de integración alternativos:Lite SDK
Una integración ligera que te da control total sobre la visualización de los métodos de pago, mientras Yuno se encarga del procesamiento seguro del pago.- Implementación en Web
- Implementación en Android
- Implementación en iOS
- Equivalente en el nuevo SDK: Migración al modo Lite en Web
Secure Fields
Crea tus propios formularios de pago desde cero con los componentes de interfaz de Yuno para lograr la máxima personalización (solo Web).- Guía de Secure Fields
- Equivalente en el nuevo SDK: Secure Fields