Como adicionar um gateway de pagamento à sua loja

Os clientes pagam você pela sua própria conta de gateway de pagamento. O dinheiro vai direto para essa conta: o portal apenas guarda as suas chaves (criptografadas) e confirma cada pagamento para que o pedido possa ser entregue.

Qual gateway usar é escolha sua. Você abre a conta com o provedor por conta própria, nos termos dele. O portal aceita cartões, carteiras digitais, transferências bancárias e cripto, e lista todos os gateways compatíveis em Supported Gateways.

Observação: tenha a sua conta de gateway pronta antes de começar. Você precisa das chaves de API do dashboard do seu provedor.

1Step 1 of 6Abra os seus gateways de pagamento

Acesse Payment gateways → All gateways. A página Payment gateways lista os gateways que você conectou e todos os gateways que o portal aceita.

2Step 2 of 6Escolha o seu gateway

Clique no seu gateway em Supported Gateways, ou clique em Add Gateway e escolha-o em Gateway. A página Add Payment Gateway mostra os campos de que esse gateway precisa e, para a maioria dos gateways, onde encontrar cada chave no dashboard do seu provedor. Para Interac, Wise e Cash App ($Cashtag), que você confirma manualmente, clique em Add Gateway e escolha-os em Gateway: os blocos deles abrem a página em que você confere os pagamentos recebidos.

Se a página Payment gateways mostrar Plan Limit Reached, o seu plano não tem mais vaga livre para gateways: o botão Add Gateway fica oculto e os blocos não podem ser clicados.

3Step 3 of 6Cole as suas chaves

Copie cada chave do dashboard do seu provedor para o campo correspondente. Os campos marcados com estrela são obrigatórios.

4Step 4 of 6Adicione o webhook, quando pedido

Alguns gateways mostram um quadro Webhook setup — required for automatic confirmation. Copie a URL desse quadro para as configurações de webhook do seu gateway, assine o evento indicado e cole a chave que o seu gateway fornecer no campo indicado. Sem o webhook, os pedidos pagos podem ficar sem confirmação.

5Step 5 of 6Salve e confira o status

Clique em Add Gateway. O gateway aparece em Configured Gateways como Active e é oferecido no checkout.

Se ele aparecer como Misconfigured, o seu provedor rejeitou as chaves e o gateway fica fora do checkout até ser corrigido. Clique em Configure, corrija as chaves e salve de novo.

6Step 6 of 6Desative ou ative um gateway

Clique em Configure no gateway e altere Gateway Status. Um gateway Inactive não é oferecido no checkout. Quando você altera as configurações, os campos secretos que você deixa em branco mantêm o valor salvo (Leave empty to keep existing value). Delete Gateway remove o gateway.

Dica: com dois gateways, use Failover Settings na mesma página para escolher um principal e um reserva por loja. A moeda de venda da sua loja é definida em Payment gateways → Currency.

Métodos manuais: Interac, Wise e Cash App ($Cashtag)

Alguns métodos não têm confirmação automática: Interac e-Transfer, Wise e Cash App ($Cashtag). Não há chaves nem webhook. O seu cliente envia o dinheiro por conta própria, com um código de referência curto na mensagem do pagamento, e você confirma que ele chegou. Para esses métodos, a página Payment gateways mostra um aviso com um link em que você confere cada pagamento e o marca como recebido.

O Cash App ($Cashtag) funciona assim:

1. Clique em Add Gateway, escolha Cash App ($Cashtag) em Gateway e informe Your $Cashtag (um $ seguido de 1 a 20 letras, números ou _, por exemplo $YourStore). Uma observação extra para os clientes é opcional.
2. No checkout, o seu cliente vê o valor, o seu $Cashtag, o código de referência que deve colocar na mensagem do Cash App e um link que abre o seu $Cashtag no Cash App. O pedido fica esperando por você.
3. Quando o pagamento aparecer no Cash App, abra Cash App payments need manual reconciliation na página Payment gateways, procure o código de referência e clique em Mark received & provision. O pedido é então entregue automaticamente.

O Cash App ($Cashtag) não é o mesmo que o Cash App Pay, que recebe pagamentos no estilo cartão por meio de uma conta Square separada e os confirma automaticamente.