Os pagamentos são processados pelos gateways que você conecta, com as taxas do seu contrato com eles. Você pode conectar mais de um gateway e decidir no fluxo de orquestração qual atende cada cobrança.
Gateways suportados
| Gateway | Pix | Boleto | Cartão | Assinatura |
|---|---|---|---|---|
| Stripe | Sim | — | Sim, no checkout (Stripe) | Sim, cartão |
| Asaas | Sim | Sim | Sim, na fatura do Asaas | Sim, cartão (Pix/boleto opcional) |
| Mercado Pago | Sim | — | — | Sim, na página do Mercado Pago |
| PayPal | — | — | Sim, na página do PayPal | Sim, na página do PayPal |
| AbacatePay | Sim | Sim | — (em breve) | — (em breve) |
“Na página do gateway” significa que o comprador é levado ao ambiente seguro do provedor e volta ao seu checkout com o pagamento confirmado. Os dados do cartão nunca passam pelo Astro.
Conectar um gateway
- Em Gateways, escolha o provedor.
- Selecione o ambiente: sandbox para testes ou produção.
- Informe as credenciais da sua conta no provedor. O Astro testa a conexão antes de salvar.
- Cadastre no painel do provedor o endereço de webhook exibido pelo Astro, para que as confirmações de pagamento cheguem automaticamente.
Segurança: credenciais e segredos de webhook são criptografados e nunca são exibidos de novo depois de salvos. O endereço de webhook e o segredo aparecem apenas na criação da conexão: guarde-os nesse momento.
Observações por gateway
- Asaas: exige o CPF ou CNPJ do comprador; o checkout passa a pedir o documento automaticamente quando a forma de pagamento usa o Asaas. No webhook, use o token de autenticação informado na conexão e ative os eventos de Cobranças e Assinaturas. Boleto não pode ser reembolsado pela API.
- PayPal: configure uma URL de retorno HTTPS na conexão. O Astro captura o pagamento assim que o comprador aprova. Cancelamento de assinatura é imediato e troca de plano exige nova aprovação.
- Mercado Pago: pagamento único somente por Pix; assinaturas são autorizadas com cartão na página do Mercado Pago.
- AbacatePay: reembolso apenas integral; boleto não pode ser reembolsado pela API.
- Stripe: cartão é confirmado no navegador do comprador; Pix exibe QR code e copia e cola quando a sua conta Stripe tem o método habilitado.