Saltar al contenido principal
Fast Checkout permite que el cliente elija una dirección de envío guardada y un método de entrega dentro del widget de la billetera, empezando por Revolut Pay. Como el pago se crea antes de que el cliente haga esa elección, la selección llega a Yuno de forma asíncrona y se adjunta al pago después: la recibes en GET /payments/{id} y en los webhooks de pago como un nodo shipping de nivel superior.

Cómo funciona

  1. Creas la sesión de checkout con las opciones de entrega que ofreces (shipping_methods).
  2. Yuno envía esas opciones a la billetera cuando se crea el pago, y el widget las muestra.
  3. El cliente elige una dirección guardada y un método de entrega dentro del widget.
  4. La billetera notifica a Yuno, que adjunta la selección al pago y completa customer_payer.shipping_address cuando el pagador no tenía una.
  5. Recibes la selección en el webhook de pago y en GET /payments/{id}.
El costo de entrega es un precio fijo ya incluido en el monto del pago: la selección nunca modifica payment.amount.

Ofrece opciones de entrega en la sesión

Envía shipping_methods al crear la sesión de checkout. El primer método viene preseleccionado en el widget, y cada método requiere su desglose summary_items (que define el resumen de precios que muestra la billetera). Si no ofreces métodos de envío pero quieres mostrar un desglose detallado o personalizar el total de la hoja de la billetera, envía en su lugar un arreglo summary_items independiente en la raíz de la sesión. Consulta Express checkout para Apple Pay y Google Pay.
  • shipping_methods[].id lo define el comercio; la selección regresa haciendo referencia a él.
  • Todos los montos usan la moneda de la sesión, en unidades mayores.

Recibe la selección en el pago

Una vez que el cliente confirma, el pago incluye la selección. El mismo nodo shipping se devuelve en GET /payments/{id} y en los webhooks de pago (payloads V1 y V2); consulta el objeto de pago para ver la referencia de campos y los ejemplos de webhooks.

Detalles del comportamiento

  • La clave shipping se omite cuando el pago no tiene una selección de envío: los pagos sin Fast Checkout no se ven afectados.
  • shipping.method.id siempre coincide con uno de los shipping_methods[].id que enviaste en la sesión; una selección que no coincide se descarta y el estado del pago se actualiza igualmente.
  • customer_payer.shipping_address se completa a partir de shipping.address solo cuando el pagador aún no tenía una dirección de envío: una dirección que enviaste en la solicitud de pago nunca se sobrescribe.
  • La selección es idempotente: las notificaciones repetidas con el mismo envío no cambian el pago.

Disponibilidad

El envío con Fast Checkout está disponible para Revolut Pay en integraciones con el SDK web que tengan requestShipping habilitado. Contacta a tu representante de Yuno para habilitarlo en tu cuenta. Para las billeteras que actualizan la hoja mientras el cliente todavía está eligiendo, consulta Express checkout de Apple Pay en iOS y Express checkout de Google Pay en Android.