Amazon Pay para TYPO3

Amazon Pay reduce los abandonos de compra porque los clientes no necesitan crear una cuenta nueva

El 70 % de los compradores online en Europa tienen una cuenta de Amazon. Cuando estos usuarios pulsan “Comprar” en una tienda TYPO3 y ven un formulario de registro con 12 campos obligatorios, muchos abandonan. Amazon Pay resuelve este problema: el cliente se autentica con su cuenta de Amazon, la dirección de envío y el medio de pago se transfieren automáticamente. Sin formulario, sin número de tarjeta, sin nueva contraseña. Según los propios case studies de Amazon, la tasa de conversión aumenta entre un 15 y un 30 %, dependiendo del sector y la calidad del checkout existente.

Para operadores de tiendas TYPO3, la integración no es plug-and-play. Amazon Pay requiere una conexión API (Login with Amazon, Amazon Pay API v2), una implementación certificada y actualizaciones de seguridad periódicas. Amazon verifica cada integración antes del go-live.

Escenarios de uso habituales

Tiendas B2C de tamaño medio con aimeos. Tiendas online de moda, electrónica o artículos para el hogar que quieren ofrecer un tercer método de pago junto a PayPal y tarjeta. Amazon Pay funciona especialmente bien en compras impulsivas por debajo de 200 euros, donde cada obstáculo en el checkout cuesta facturación directamente. La integración en aimeos se realiza mediante un service provider propio que se conecta a la pipeline de pago.

Plataformas de donaciones y cuotas de membresía. Asociaciones y ONGs que recaudan donaciones o cuotas a través de su web TYPO3 se benefician de la baja barrera de entrada. El donante pulsa “Pagar con Amazon”, confirma el importe y listo. Sin teclear IBAN, sin configurar domiciliación bancaria. Para pagos recurrentes, Amazon Pay soporta Recurring Payments.

Productos digitales y descargas. Licencias de software, e-books, cursos online - productos sin envío físico se benefician especialmente porque el proceso completo de compra se completa en menos de 30 segundos. No se necesita dirección de envío, solo autenticación y pago.

Arquitectura técnica

Amazon Pay v2 se basa en una API REST con payloads JSON. El flujo en una tienda TYPO3: el cliente pulsa el botón de Amazon Pay, es redirigido a Amazon (o se abre un popup), inicia sesión y confirma dirección y medio de pago. Amazon devuelve un Access Token a la tienda. La tienda crea una Checkout Session vía la API de Amazon Pay con datos del carrito y detalles del pedido. Tras la confirmación del cliente, se ejecuta el pago.

La integración en TYPO3 requiere tres componentes: un cliente API (peticiones HTTP a la API de Amazon Pay con firma RSA), un componente frontend (botón Amazon Pay como widget JavaScript) y un handler de webhooks para notificaciones asíncronas (confirmación de pago, reembolso, chargeback).

Para aimeos existe un plugin de la comunidad que cubre las funciones básicas. Para tt_products o tiendas a medida se necesita una integración propia. En ambos casos la tienda TYPO3 debe usar HTTPS (obligatorio desde Amazon Pay v2) y la URL del webhook debe ser accesible desde el exterior.

Amazon proporciona un entorno sandbox donde todos los flujos de pago pueden probarse sin dinero real.

Problemas frecuentes y soluciones

La certificación falla en el primer intento. Amazon verifica antes del go-live que la integración funcione correctamente: ubicación del botón, manejo de errores en pagos rechazados, visualización en móviles, cancelación correcta. Errores frecuentes: el botón de Amazon Pay no aparece en la página de producto (solo en el carrito), faltan mensajes de error por rechazo de pago o están en inglés. Solución: completar la Integration Checklist de Amazon antes de solicitar la revisión.

Las notificaciones IPN (Instant Payment Notifications) se pierden. Amazon envía confirmaciones de pago de forma asíncrona por POST a una URL registrada. Si TYPO3 bloquea esas peticiones por caché, reglas de redirección o falta de excepciones CSRF, el pedido se queda en estado “pendiente”. Solución: configurar una ruta eID dedicada o middleware que opere fuera del procesamiento normal de peticiones TYPO3.

Pagos recurrentes y modelos de suscripción. Amazon Pay soporta pagos recurrentes, pero la configuración es más compleja que con Stripe Subscriptions. El cliente debe aceptar explícitamente un Billing Agreement y la tienda debe enviar regularmente peticiones Authorize. Solución: gestionar los Billing Agreements como entidad propia en base de datos y configurar un cronjob que active los pagos vencidos.

Migración y compatibilidad de versiones

Amazon Pay v2 es la versión actual de la API (desde 2021). La versión 1 ya no se acepta para nuevas integraciones desde finales de 2023. Las implementaciones v1 existentes siguen funcionando pero no reciben actualizaciones ni nuevas funcionalidades. La migración de v1 a v2 afecta al cliente API completo: otros endpoints, otro mecanismo de firma (RSA en lugar de HMAC), otra gestión de sesiones.

Para TYPO3 no existe una extensión oficial de Amazon Pay en el TER con soporte activo para v12/v13. La integración se realiza como código a medida o mediante plugins de la comunidad para aimeos. Gosign implementa Amazon Pay como paquete Composer independiente que se integra en cualquier configuración de tienda TYPO3. Este paquete encapsula el cliente API, el botón y el handler de webhooks, de modo que un upgrade major de TYPO3 solo afecta a la capa adaptadora específica de TYPO3.

Para operadores de tienda que ofrecen Amazon Pay junto con PayPal, tarjeta y Klarna, Gosign recomienda una abstracción de pago unificada. En lugar de integrar cada proveedor individualmente, se implementa una interfaz común que gestiona todos los proveedores. aimeos trae esta abstracción de forma nativa (arquitectura de service providers). Para tiendas a medida, Gosign construye una capa comparable que desacopla el código del checkout de las APIs específicas de cada proveedor.

Los costes totales de una integración de Amazon Pay en una tienda TYPO3 existente oscilan entre 3 y 8 días de desarrollo, dependiendo de si se puede usar un plugin de aimeos o es necesaria una integración a medida. La certificación de Amazon requiere adicionalmente de 1 a 2 días para preparación y rondas de corrección.