Amazon Pay para TYPO3

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

Una gran parte de los compradores online en Europa tiene 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 un estudio de comScore encargado por Amazon Pay (EE. UU., 40 comercios), la tasa de conversión con Amazon Pay fue de media un 35 % superior a la del checkout propio de los comercios.

Para operadores de tiendas TYPO3, la integración no es plug-and-play. Amazon Pay requiere una conexión API (Amazon Pay API v2), los dominios de la tienda registrados en Seller Central y actualizaciones de seguridad periódicas. Amazon revisa los dominios antes del go-live conforme a su política de uso aceptable.

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 no requiere rellenar ningún formulario de la tienda. 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 redirige a la tienda con el ID de la Checkout Session creada al pulsar el botón. La tienda completa la Checkout Session vía la API de Amazon Pay con el importe y los 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, la documentación no incluye ningún proveedor de Amazon Pay; la conexión se construye como service provider propio. Para tt_products o tiendas a medida se necesita una integración propia. En ambos casos la tienda TYPO3 debe usar HTTPS (obligatorio para el endpoint IPN en producción) 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

Checklist de lanzamiento incompleta. Antes del go-live, la tienda prueba en el sandbox los casos de éxito y de error y completa la checklist de Amazon: 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 checklist previa al lanzamiento de Amazon antes de que la tienda entre en producció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 en el checkout una Charge Permission recurrente y la tienda ejecuta cada pago pendiente con Create Charge. Solución: gestionar las Charge Permissions 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 2020). Para nuevas integraciones, Amazon recomienda la versión 2. 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, en aimeos como service provider propio. 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 la tienda funciona con aimeos y su interfaz de proveedores o es necesaria una integración a medida. Las pruebas en el sandbox y la checklist de lanzamiento requieren adicionalmente de 1 a 2 días para preparación y rondas de corrección.