Para permitir que los usuarios confirmen la compra, debes implementar la integración de confirmación de compra nativa. Esto implica crear una API de REST estándar que permita a Google administrar de forma programática el proceso de confirmación de compra con tus servidores. Este método proporciona la experiencia más fluida para los usuarios. Inicialmente, Google renderizará la interfaz de usuario para el comprador, con planes futuros para admitir experiencias más agentivas.
Flujo de confirmación de la compra
La integración nativa requiere que compiles una API de RESTful a la que Google pueda llamar para crear y administrar sesiones de confirmación de la compra.
El flujo general es el siguiente:
- Compila la sesión de confirmación de la compra: El usuario y, de manera opcional, un agente están en un bucle que agrega elementos a la sesión.
- Transferencia a una IU de Google: Una vez que el usuario decide confirmar la compra, el agente (si está involucrado) pasa el control a una IU de Google (y pasa los datos de la sesión de confirmación de la compra).
- Confirmación de la compra manual: Ahora, el usuario interactúa solo con la IU de Google para completar los detalles sensibles de cumplimiento y pago, y enviar el pedido. El agente no participa en esta parte, lo que garantiza el determinismo.
- Finalización y devolución: La IU de Google muestra una página de agradecimiento para confirmar el pedido. De manera opcional, se puede redireccionar al usuario al agente, quien ya podría haber recibido una notificación de la compra completada.
Ciclo de vida del estado de la sesión de confirmación de la compra
A medida que el usuario avanza en el flujo de confirmación de la compra, debes actualizar el status de la sesión de confirmación de la compra para reflejar su estado actual. La sesión pasa por el siguiente ciclo de vida:
incomplete: Es el estado inicial cuando se crea una sesión. Indica que falta información obligatoria (como métodos de envío, impuestos o detalles del usuario) o que no se calculó.ready_for_payment: Es el estado que se debe usar después de que el usuario actualiza su dirección de envío y tú calculas las opciones y los totales de envío, pero antes de que se finalice el instrumento de pago.ready_for_complete: Es el estado que se debe usar durante la hidratación completa del objeto de confirmación de la compra, una vez que se selecciona el instrumento de pago y se validan todos los detalles del pedido.completed: Es el estado final que se muestra después de procesar correctamente el pago y realizar el pedido.canceled: Es el estado que se muestra si se anula la sesión de confirmación de la compra.error: Es el estado que se muestra si un error de lógica empresarial irrecuperable impide la confirmación de la compra. Este estado está disponible en la versión2026-04-08de UCP y versiones posteriores.
Flujo de confirmación de la compra de varios artículos:
Ahora, Google admite varios artículos distintos en una sola sesión de confirmación de la compra. El flujo general es el siguiente:
- El usuario inicia la confirmación de la compra desde una interfaz habilitada para UCP (p.ej., haciendo clic en "Comprar ahora" en un producto).
- Se realiza la llamada
POST /checkout-sessions, que incluye todos los elementos distintos en el arrayline_items. El arrayline_itemscontendrá un objeto separado para cada elemento único que se confirme. - El usuario puede actualizar su instrumento de pago, los detalles de cumplimiento o aplicar descuentos con llamadas
PUT /checkout-sessions/{id}. - Cuando el usuario hace clic en el botón "Pagar con GPay", se realiza la llamada
POST /checkout-sessions/{id}/complete.
Autenticación
Para obtener detalles sobre cómo proteger tus extremos de la API de confirmación de la compra nativa, incluidos los métodos de autenticación compatibles , como las claves de API y OAuth 2.0, consulta la guía de autenticación y seguridad.
Herramientas para desarrolladores
Para ayudarte con la implementación de la API de compra nativa, puedes encontrar los siguientes recursos en el repositorio de GitHub del Universal Commerce Protocol:
- Repositorio de GitHub de UCP: Explora el repositorio principal para obtener documentación completa, especificaciones y recursos de la comunidad.
- SDKs: Usa los kits de desarrollo de software para acelerar tu integración. Hay SDKs específicos del lenguaje disponibles, incluidos los siguientes:
Pruebas de conformidad: Valida tus extremos de API con la especificación de UCP usando el conjunto de pruebas de conformidad .
Esto ayuda a garantizar que tu implementación cumpla con los estándares y comportamientos requeridos.
Te recomendamos usar estas herramientas para optimizar tu proceso de desarrollo y pruebas.
Objetivos de nivel de servicio
Los siguientes objetivos de nivel de servicio (SLO) se aplican a los extremos de la API de REST de confirmación de la compra nativa. Se espera que las empresas que se integren con Google cumplan con estos objetivos de rendimiento y disponibilidad de la API.
| Extremo | Disponibilidad | Latencia (percentil 50) | Latencia (percentil 95) |
|---|---|---|---|
POST /checkout-sessions (Crear) |
>= 95% | <= 1 segundo | <= 4 segundos |
PUT /checkout-sessions/{id} (Actualizar) |
>= 95% | <= 1 segundo | <= 5 segundos |
POST /checkout-sessions/{id}/complete (Completar) |
>= 95% | <= 6 segundos | <= 10 segundos |
La latencia del percentil 50 indica que se espera que, al menos, el 50% de las solicitudes se completen en este tiempo. La latencia del percentil 95 indica que se espera que, al menos, el 95% de las solicitudes se completen en este tiempo.
Próximos pasos
Consulta las cargas útiles de la API de confirmación de la compra y los detalles de implementación técnica para tu versión de UCP: