Yuno es el sistema operativo de IA para pagos, y un pago es lo primero que ejecutas en él. Envías tu primer pago en sandbox en unos 10 minutos, una vez que tienes las credenciales de sandbox.
Antes de empezar
Necesitas estos datos para cada llamada de esta página.Obtén tus credenciales de sandbox
- Código de cuenta, que aparece como
account_iden el dashboard public-api-keyprivate-secret-key
sandbox_. Las claves de producción son distintas y empiezan con prod_.
https://api-sandbox.y.uno/v1.id. Guárdalo como YUNO_CUSTOMER_ID: los pasos de pago lo usan.POST /v1/customers responde 201.401significa que el par de claves es incorrecto. Vuelve a copiar las dos claves de sandbox desde Developers.404con el cuerpo vacío significa que falta/v1en la URL base.
Conecta el Yuno Test Payment Gateway y publica una ruta
- Abre Connections, busca Yuno Test Payment Gateway, haz clic en Connect, ponle un nombre a la conexión y haz clic en Save.
- Abre Routing, abre la pestaña Not published, busca Card y haz clic en Set Up.
- Haz clic en + Create new route, ponle un nombre y haz clic en Save.
- Haz clic en la flecha, elige Add step, selecciona Yuno Test Payment Gateway y haz clic en Publish.
- Abre Checkout builder, activa Card y publica la configuración.
CARD. Crea una sesión como en el paso 4 y guarda su checkout_session como YUNO_CHECKOUT_SESSION. Luego llama a GET /v1/checkout/sessions/{checkout_session}/payment-methods y busca "type": "CARD" en la lista.Si falta CARD, revisa las tres configuraciones: el Test Payment Gateway está conectado, la ruta de Card está en Published y Card está activado en el Checkout builder.Elige cómo se crea el pago
workflow le indica a Yuno quién crea el pago. Elige uno y usa la pestaña correspondiente en el paso 4.INTERNAL_ERROR. Consulta Primeros pasos con el Yuno SDK y Flujo directo para ver cada camino completo.SDK_SEAMLESS, SDK_CHECKOUT o DIRECT. La sesión de checkout (caminos con SDK) o el pago (DIRECT) lo lleva en el campo workflow.Envía el pago
- DIRECT
- SDK_SEAMLESS
- SDK_CHECKOUT
DIRECT es un pago directo en el que tu servidor envía los datos de la tarjeta. Usa el id del cliente que guardaste como YUNO_CUSTOMER_ID en el paso 1.Crea el pago con una tarjeta de prueba. Envía un X-Idempotency-Key nuevo con cada pago.status del pago es SUCCEEDED con la tarjeta de prueba 4507 9900 0000 0002 (11/28, CVV 123, John Doe).Mira el resultado
- Revisa
statusysub_statusen la respuesta.SUCCEEDEDconAPPROVEDsignifica que el gateway aprobó el pago. - Abre Payments en el dashboard, busca tu pago y ábrelo para ver sus detalles.
- Para recibir el resultado en tu servidor, configura un webhook y verifica su firma (HMAC).
SUCCEEDED en la lista Payments del dashboard y en el campo status de tu respuesta.Siguientes pasos
Salir a producción
Solución de problemas
La API devuelve 401
La API devuelve 401
public-api-key o private-secret-key, o es incorrecto. Sandbox y producción usan claves distintas, así que verifica que copiaste las claves de sandbox desde el dashboard en Test Mode. Consulta Autenticación.El pago termina en INTERNAL_ERROR
El pago termina en INTERNAL_ERROR
workflow no coincide con tu integración. Usa DIRECT cuando tu servidor envía la tarjeta, y SDK_SEAMLESS en la sesión de checkout cuando el Web SDK crea el pago.Ningún proveedor procesa el pago
Ningún proveedor procesa el pago
La tarjeta es rechazada
La tarjeta es rechazada
¿Un término no está claro? Consulta el Glosario. Para URLs, claves y specs, consulta Developers.