Un pago exitoso en sandbox es el punto de partida. Recorre estos cinco pasos con tus equipos de ingeniería y de operaciones antes de enviar transacciones reales.
Activa Live Mode y cambia a las claves de producción
- Copia las claves de Live desde Developers. Yuno mantiene claves separadas para Test y Live. Consulta Credenciales de Developers.
- Revisa el prefijo de la clave. Las claves de sandbox empiezan con
sandbox_y las de producción conprod_. El Yuno SDK elige el entorno a partir de este prefijo. Consulta Primeros pasos con el Yuno SDK. - Apunta tu servidor a la URL base de producción, que aparece en Developers.
- Mantén la
private-secret-keyen tu servidor y fuera de lugares públicos, como un repositorio de GitHub. Consulta Autenticación.
Conecta un proveedor de producción y publica la ruta
- Con el indicador de contexto en Live, abre Connections y conecta cada proveedor con el que vas a lanzar.
- Abre Routing y revisa la pestaña Not published. Ahí aparece cada método de pago que tiene una conexión pero no tiene ruta.
- Crea la ruta, agrega el paso del proveedor y haz clic en Publish. Consulta Routing.
- Abre Checkout builder, activa los métodos de pago que tienen una ruta publicada y haz clic en Publish settings. Los cambios quedan como Not published hasta que los publicas.
Configura el webhook de producción y los reintentos seguros
- Configura un webhook de producción con una URL HTTPS pública que devuelva HTTP 200. Yuno reintenta una entrega que no recibe HTTP 200, así que el mismo evento puede llegar más de una vez. Los eventos de reembolso y de contracargo llevan el mismo
data.payment.idempotency_keyque su pago, así que registra cada evento procesado con suaccount_id, sutype_eventy su clave de idempotencia juntos, y omite un evento que ya esté registrado. Consulta Deduplicación. - Activa Use HMAC Authentication y verifica el encabezado
x-hmac-signaturecontra el cuerpo sin procesar de la solicitud, antes de parsear el JSON, con el secreto configurado para ese webhook. Consulta Verificar firmas de webhook. - Envía un
X-Idempotency-Keycuando crees un pago. Si el resultado no está claro (un timeout, un error de conexión o un500), reintenta con la misma clave. Un400 REQUEST_IN_PROCESSsignifica que la primera solicitud todavía se está ejecutando, así que reintenta con la misma clave después de unos segundos. Un400 IDEMPOTENCY_DUPLICATEDsignifica que no existe ningún pago para esa clave, así que corrige la solicitud y envíala con una clave nueva. Consulta Idempotencia. - Usa Retrieve payment para recuperar el estado de un pago cuando el resultado de un webhook o de una solicitud no está claro.
Decide sobre 3DS y tu alcance PCI
DIRECT del Quickstart, tus sistemas quedan dentro del alcance PCI DSS. Consulta Cumplimiento PCI.Haz un pago real y un reembolso, y sigue los primeros pagos
- Reembolsa con Refund payments. Cada llamada de reembolso necesita un
X-Idempotency-Keycon un valor nuevo en cada intento. Espera a que un reembolso llegue aSUCCEEDED,DECLINEDoERRORantes de iniciar otro sobre la misma transacción. - Si un reembolso se confirma de inmediato o queda en
PENDING, y si se permiten reembolsos parciales, depende del proveedor. Revisa el comportamiento de cada proveedor con el que lances. - Abre Payments en el dashboard en Live Mode para ver todos los pagos y transacciones, filtrarlos y exportar reportes. Consulta Payments.
- Consulta el estado del servicio ante incidentes, y escribe a support@y.uno con el ID del pago cuando un resultado no coincida con lo que esperas.
Prueba más allá del camino feliz
Antes del lanzamiento, demuestra que tu aplicación maneja cada uno de estos casos. Usa el Yuno Testing Gateway en sandbox y las instrucciones de prueba de cada proveedor. Los resultados en sandbox no demuestran cómo se comporta cada proveedor en producción.Siguientes pasos
- Solución de problemasReferencia La respuesta, su causa y la solución para los primeros errores de una integración nueva.
- WebhooksGuía Entrega, reintentos, deduplicación y las páginas para configurar y verificar un webhook.
- Flujo de pagoConcepto Cada paso de un pago, campo por campo.
- Crear pagoReferencia El esquema de la solicitud y de la respuesta de la llamada que crea un pago.