Amazon Pay para TYPO3

Amazon Pay reduz abandonos de compra porque clientes não precisam criar conta nova

Milhões de compradores online possuem uma conta Amazon. Quando esses usuários clicam em “Comprar” em uma loja TYPO3 e veem um formulário de cadastro com 12 campos obrigatórios, muitos desistem. Amazon Pay resolve esse problema: o cliente se autentica com sua conta Amazon, endereço de entrega e forma de pagamento são transferidos automaticamente. Sem formulário, sem número de cartão de crédito, sem nova senha. Segundo case studies da própria Amazon, a taxa de conversão aumenta entre 15 e 30%, dependendo do setor e da qualidade do checkout existente.

Para operadores de lojas TYPO3, a integração não é plug-and-play. Amazon Pay requer conexão via API (Login with Amazon, Amazon Pay API v2), uma implementação certificada e atualizações de segurança regulares. A Amazon verifica cada integração antes do go-live.

Cenários típicos de uso

Lojas B2C de médio porte com aimeos. Lojas online de moda, eletrônicos, utilidades domésticas que querem oferecer uma terceira forma de pagamento além de PayPal e cartão de crédito. Amazon Pay funciona especialmente bem em compras impulsivas abaixo de 200 euros, onde cada obstáculo no checkout custa faturamento diretamente. A integração no aimeos ocorre via service provider próprio, inserido na pipeline de pagamento.

Plataformas de doações e mensalidades. Associações e ONGs que arrecadam doações ou cobram mensalidades pelo site TYPO3 se beneficiam da baixa barreira de entrada. O doador clica em “Pagar com Amazon”, confirma o valor e pronto. Sem digitar IBAN, sem configurar débito automático. Para pagamentos recorrentes, Amazon Pay suporta Recurring Payments.

Produtos digitais e downloads. Licenças de software, e-books, cursos online - produtos sem envio físico se beneficiam especialmente, porque todo o processo de compra é concluído em menos de 30 segundos. Sem necessidade de endereço de entrega, apenas autenticação e pagamento.

Arquitetura técnica

Amazon Pay v2 é baseado em uma API REST com payloads JSON. O fluxo em uma loja TYPO3: o cliente clica no botão Amazon Pay, é redirecionado para a Amazon (ou um popup se abre), faz login e confirma endereço e forma de pagamento. A Amazon envia um Access Token de volta para a loja. A loja cria uma Checkout Session via Amazon Pay API, onde dados do carrinho e detalhes do pedido são armazenados. Após confirmação pelo cliente, o pagamento é acionado.

A integração no TYPO3 requer três componentes: um cliente API (requests HTTP para a Amazon Pay API com assinatura via chave RSA), um componente frontend (botão Amazon Pay como widget JavaScript) e um handler de webhook para notificações assíncronas (confirmação de pagamento, reembolso, chargeback).

Para aimeos existe um plugin da comunidade que cobre as funções básicas. Para tt_products ou lojas personalizadas, é necessária uma integração própria. Em ambos os casos, a loja TYPO3 deve usar HTTPS (obrigatório desde Amazon Pay v2), e a URL de webhook deve ser acessível externamente.

A Amazon disponibiliza um ambiente sandbox onde todos os fluxos de pagamento podem ser testados sem dinheiro real.

Problemas frequentes e soluções

Certificação falha na primeira tentativa. A Amazon verifica antes do go-live se a integração funciona corretamente: posicionamento do botão, tratamento de erros em pagamentos recusados, exibição em dispositivos móveis, cancelamento correto. Erros frequentes: o botão Amazon Pay não aparece na página do produto (apenas no carrinho), mensagens de erro em pagamentos recusados faltam ou estão em inglês. Solução: trabalhar completamente o checklist de integração da Amazon antes de solicitar a verificação.

Notificações IPN (Instant Payment Notifications) se perdem. A Amazon envia confirmações de pagamento assincronamente via POST para uma URL registrada. Se o TYPO3 bloqueia esses requests por cache, regras de redirect ou exceções CSRF ausentes, o pedido permanece no status “pendente”. Solução: configurar uma rota eID dedicada ou rota middleware para o webhook, que rode fora do processamento normal de requests TYPO3.

Recurring Payments e modelos de assinatura. Amazon Pay suporta pagamentos recorrentes, mas a configuração é mais complexa que Stripe Subscriptions. O cliente deve consentir explicitamente a um Billing Agreement, e a loja deve enviar Authorize-Requests regularmente. Solução: gerenciar Billing Agreements como entidade de banco de dados própria e configurar um cronjob que aciona pagamentos devidos.

Migração e compatibilidade de versões

Amazon Pay v2 é a versão atual da API (desde 2021). A versão 1 não é mais aceita para novas integrações desde o final de 2023. Implementações v1 existentes ainda funcionam, mas não recebem atualizações nem novos recursos. A migração de v1 para v2 afeta todo o cliente API: outros endpoints, outro mecanismo de assinatura (RSA em vez de HMAC), outro gerenciamento de sessão.

Para TYPO3 não existe uma extensão oficial Amazon Pay no TER com suporte ativo v12/v13. A integração ocorre como código personalizado ou via plugins da comunidade para aimeos. A Gosign implementa Amazon Pay como pacote Composer independente, que pode ser integrado em qualquer setup de loja TYPO3. Este pacote encapsula o cliente API, o botão e o handler de webhook, de modo que um upgrade TYPO3 major afeta apenas a camada adaptadora específica do TYPO3.

Os custos totais de uma integração Amazon Pay em uma loja TYPO3 existente ficam entre 3 e 8 dias de desenvolvimento, dependendo se um plugin aimeos pode ser utilizado ou se uma integração personalizada é necessária. A certificação Amazon requer adicionalmente 1 a 2 dias para preparação e rodadas de correção.