Saltar al contenido principal
Primeros pasosTutorial · unos 10 minutos

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.

Crea una conexiónEnvía un pago con una tarjeta de pruebaMíralo en el dashboard

Antes de empezar

Necesitas estos datos para cada llamada de esta página.
1

Obtén tus credenciales de sandbox

Inicia sesión en el dashboard de Yuno y abre Developers para encontrar tres valores:
  • Código de cuenta, que aparece como account_id en el dashboard
  • public-api-key
  • private-secret-key
Las claves de sandbox empiezan con sandbox_. Las claves de producción son distintas y empiezan con prod_.
Página de inicio de sesión del dashboard de Yuno
Si todavía no tienes una cuenta, pídela a tu contacto en Yuno o escribe a sales@y.uno. Por ahora no hay registro autogestionado.Define tus credenciales como variables de entorno:
Shell
Comprueba las claves creando un cliente. La URL base es https://api-sandbox.y.uno/v1.
La respuesta incluye un id. Guárdalo como YUNO_CUSTOMER_ID: los pasos de pago lo usan.
Paso completado cuando POST /v1/customers responde 201.
  • 401 significa que el par de claves es incorrecto. Vuelve a copiar las dos claves de sandbox desde Developers.
  • 404 con el cuerpo vacío significa que falta /v1 en la URL base.
2

Conecta el Yuno Test Payment Gateway y publica una ruta

El Yuno Test Payment Gateway simula un proveedor de tarjetas. Funciona solo en sandbox y no necesita credenciales.
  1. Abre Connections, busca Yuno Test Payment Gateway, haz clic en Connect, ponle un nombre a la conexión y haz clic en Save.
  2. Abre Routing, abre la pestaña Not published, busca Card y haz clic en Set Up.
  3. Haz clic en + Create new route, ponle un nombre y haz clic en Save.
  4. Haz clic en la flecha, elige Add step, selecciona Yuno Test Payment Gateway y haz clic en Publish.
  5. Abre Checkout builder, activa Card y publica la configuración.
Paso completado cuando una nueva sesión de checkout incluye 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.
3

Elige cómo se crea el pago

El campo workflow le indica a Yuno quién crea el pago. Elige uno y usa la pestaña correspondiente en el paso 4.Una sesión y una integración que no coinciden terminan en INTERNAL_ERROR. Consulta Primeros pasos con el Yuno SDK y Flujo directo para ver cada camino completo.
Paso completado cuando puedes decir qué workflow vas a enviar: SDK_SEAMLESS, SDK_CHECKOUT o DIRECT. La sesión de checkout (caminos con SDK) o el pago (DIRECT) lo lleva en el campo workflow.
4

Envía el pago

Enviar números de tarjeta sin procesar desde tu servidor es para pruebas en sandbox. En producción requiere alcance PCI DSS. Si no lo tienes, usa el Yuno SDK o Secure Fields para recopilar los datos de la tarjeta.
El workflow 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.
El pago es exitoso cuando la respuesta se ve así:
Response (trimmed)
Paso completado cuando el status del pago es SUCCEEDED con la tarjeta de prueba 4507 9900 0000 0002 (11/28, CVV 123, John Doe).
5

Mira el resultado

  • Revisa status y sub_status en la respuesta. SUCCEEDED con APPROVED significa 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).
Los estados de pago aparecen en Estados de pago.
Paso completado cuando el pago aparece como SUCCEEDED en la lista Payments del dashboard y en el campo status de tu respuesta.

Siguientes pasos

Salir a producción

GuíaClaves de producción, una ruta publicada, webhooks verificados y un primer pago real.

Solución de problemas

Falta el encabezado 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 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.
Card no tiene una ruta publicada. Abre Routing y verifica que la ruta de Card con el Yuno Test Payment Gateway esté en la pestaña Published, y que Card esté activado en el Checkout builder.
Las tarjetas de prueba son específicas de cada proveedor. Las tarjetas de este Quickstart solo funcionan cuando tu sandbox enruta Card al Yuno Test Payment Gateway. Los otros resultados aparecen en la página del Yuno Test Payment Gateway.

¿Un término no está claro? Consulta el Glosario. Para URLs, claves y specs, consulta Developers.