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 um estudo da comScore encomendado pela Amazon Pay (EUA, 40 lojistas), a taxa de conversão com Amazon Pay foi em média 35% maior que a do checkout próprio dos lojistas.

Para operadores de lojas TYPO3, a integração não é plug-and-play. Amazon Pay requer conexão via API (Amazon Pay API v2), domínios da loja cadastrados no Seller Central e atualizações de segurança regulares. A Amazon revisa os domínios antes do go-live conforme sua política de uso aceitável.

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 dispensa o preenchimento de formulários da loja. 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 redireciona de volta à loja com o ID da Checkout Session criada no clique do botão. A loja complementa a Checkout Session via Amazon Pay API com o valor e os detalhes do pedido. 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, a documentação não lista nenhum provider de Amazon Pay; a conexão é criada como service provider próprio. 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 para o endpoint IPN em produção), 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

Checklist de go-live incompleto. Antes do go-live, a loja testa no sandbox os casos de sucesso e de erro e cumpre o checklist da Amazon: 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: cumprir completamente o checklist pré-lançamento da Amazon antes de a loja entrar no ar.

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 no checkout a uma Charge Permission recorrente, e a loja aciona cada pagamento devido via Create Charge. Solução: gerenciar Charge Permissions 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 2020). Para novas integrações, a Amazon recomenda a versão 2. 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, no aimeos como service provider próprio. 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 a loja roda no aimeos com sua interface de providers ou se uma integração personalizada é necessária. Os testes no sandbox e o checklist de go-live exigem adicionalmente 1 a 2 dias para preparação e rodadas de correção.