GET /payments/{id} y en los webhooks de pago como un nodo shipping de nivel superior.
Cómo funciona
- Creas la sesión de checkout con las opciones de entrega que ofreces (
shipping_methods). - Yuno envía esas opciones a la billetera cuando se crea el pago, y el widget las muestra.
- El cliente elige una dirección guardada y un método de entrega dentro del widget.
- La billetera notifica a Yuno, que adjunta la selección al pago y completa
customer_payer.shipping_addresscuando el pagador no tenía una. - 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íashipping_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[].idlo 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 nodoshipping 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
shippingse omite cuando el pago no tiene una selección de envío: los pagos sin Fast Checkout no se ven afectados. shipping.method.idsiempre coincide con uno de losshipping_methods[].idque enviaste en la sesión; una selección que no coincide se descarta y el estado del pago se actualiza igualmente.customer_payer.shipping_addressse completa a partir deshipping.addresssolo 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 tenganrequestShipping 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.