Skip to main content
O Therius disponibiliza plugins para as principais plataformas de e-commerce para que você possa aceitar pagamentos — cartões mais quaisquer métodos de pagamento alternativos que a sua configuração de checkout habilitar — sem construir uma integração de API você mesmo. Cada plugin monta o Widget de checkout, então você tem 3D Secure, cartões salvos e botões de carteira de fábrica, e cada transação passa pelo roteamento inteligente e uma única camada de webhooks.

​
Plugins disponíveis

Os plugins Beta estão completos em recursos e passam pela revisão de código, mas ainda não foram verificados contra uma instalação de loja ao vivo. Teste a fundo no seu próprio ambiente de staging antes de entrar em produção. Veja a página de cada plugin para as suas limitações conhecidas específicas.

WooCommerce

Magento 2

PrestaShop

Shopware 6

​
O que todo plugin faz da mesma forma

Dois ambientes, dois conjuntos de chaves. Cada plugin armazena as suas credenciais de Sandbox e de Produção lado a lado. Um único botão Modo de teste decide qual conjunto é usado no checkout — Sandbox roteia para https://api-sandbox.therius.io, Produção para https://api.therius.io. Você nunca precisa trocar as chaves para se mover entre ambientes. Chaves que você configura (a partir do seu painel do Therius): Os webhooks são obrigatórios, não opcionais. A chamada de checkout diz o resultado no momento da cobrança, mas a confirmação de captura, os reembolsos, os cancelamentos e os chargebacks acontecem todos depois dessa resposta. Sem um webhook configurado, os pedidos que foram apenas autorizados ficam sem resolução, e os reembolsos ou disputas tratados pelo painel do Therius nunca se refletem no pedido da loja.
  1. No painel do Therius, vá para Developers → Webhooks e adicione um endpoint. A página de cada plugin lista a URL exata para aquela plataforma. Crie um endpoint em modo Sandbox e um em modo Produção se você usar os dois.
  2. Assine ao menos: payment.captured, payment.refused, payment.refunded, payment.cancelled, payment.chargeback (veja a lista completa de eventos).
  3. Copie o segredo de assinatura de cada ambiente no campo correspondente da configuração do plugin.
Todo webhook recebido é verificado com X-Therius-Signature (HMAC-SHA256 sobre o corpo bruto) antes de qualquer coisa ser aplicada — requisições sem assinatura ou com assinatura incorreta são rejeitadas com 401. As entregas são refeitas e podem chegar mais de uma vez; os plugins as deduplicam. Reembolsos. Um reembolso emitido pelo admin da loja chama o Therius e depois aguarda o webhook payment.refunded para mover o pedido ao seu estado reembolsado. Os registros de reembolso do próprio plugin são criados de imediato pela plataforma; o webhook mantém o Therius e a loja sincronizados.

​
Construir a sua própria integração em vez disso

Se a sua plataforma não estiver listada, ou você precisar de controle total sobre o checkout, integre a API diretamente — comece com o Quickstart e o guia de Checkout de navegador.