Como ligar um gateway de pagamento
Conecte Asaas, Mercado Pago, Pagar.me, PagBank, Appmax e outros ao Plasma, escolha Pix, cartão e boleto e configure o parcelamento.
Gateways disponíveis
O Plasma cobra pelo gateway que você já usa. Cada gateway aceita os métodos que a API dele oferece:
| Gateway | Pix | Cartão | Boleto |
|---|---|---|---|
| Appmax | Sim | Sim | Sim |
| Asaas | Sim | Sim | Sim |
| BlackCat | Sim | Não | Não |
| Hyper Cash | Sim | Sim | Sim |
| IronPay | Sim | Sim | Não |
| Mercado Pago | Sim | Sim | Sim |
| Nova Era | Sim | Não | Não |
| Pagar.me | Sim | Sim | Sim |
| PagBank | Sim | Sim | Sim |
| Stripe | Não | Sim | Não |
| Velora | Sim | Não | Sim |
A lista completa e sempre atual fica em Gateway, no painel.
Passo a passo
Escolha o gateway
No painel, abra Gateway e clique no gateway que você quer ligar.
Cole as credenciais
Cada gateway pede as chaves da API dele, e a tela diz onde achar cada uma. Dois exemplos:
- Asaas: no painel do Asaas, em Integrações, Gerar API Key.
- Mercado Pago: em Mercado Pago Developers, Suas integrações, Credenciais de produção. O Mercado Pago pede o Access Token e a Public Key, que é a usada para proteger os dados do cartão no navegador.
Configure o parcelamento
Para cartão, defina:
- Taxa de juros mensal (%): a taxa cobrada do comprador por mês. Deixe
0para parcelar sem juros. - Máximo de parcelas.
- Parcelas sem juros: quais parcelas saem sem juros.
1, 2, 3deixa 1x, 2x e 3x sem juros, e a taxa vale a partir de 4x.
Ligue os métodos
Ligue Processar cartão de crédito, Processar Pix e Processar Boleto conforme o que você quer vender por esse gateway. O boleto vem desligado por padrão.
O switch faz duas coisas: decide se o método aparece no checkout e define este gateway como o titular do método, o que faz a primeira cobrança. Se dois gateways tiverem o mesmo switch ligado, o titular é o que foi configurado primeiro.
Cadastre o webhook no gateway
A tela mostra uma URL de Webhook. Copie e cadastre no painel do gateway, com os eventos que a tela indica.
Sem o webhook, o Plasma não fica sabendo quando o Pix é pago ou o pagamento muda de situação, e os pedidos não avançam. Este passo é obrigatório.
No Asaas fica em Configurações, Notificações, Webhook, Adicionar URL. No Mercado Pago, em Suas integrações, Webhooks, Criar webhook.
Mais de um gateway
Com dois ou mais gateways ligados, você decide o que acontece quando o titular falha. Isso é a cadeia de retentativas.
Retentativas
Monte a ordem em que os gateways são tentados quando o titular falha.
Sugestão de pagamento
Ofereça Pix ou outro cartão quando o banco recusar o cartão do comprador.
Problemas comuns
O Pix foi pago e o pedido continua pendente. Confira o webhook no painel do gateway: a URL tem que ser a da tela do Plasma, com os eventos indicados.
O método não aparece no checkout. O switch do método precisa estar ligado em pelo menos um gateway, e o gateway precisa aceitar o método (veja a tabela acima).
Quero tirar um gateway de um método. Desligue o switch do método nele. Se outro gateway tiver o mesmo switch ligado, ele passa a ser o titular.