Pular para o conteúdo

Orquestração de pagamentos

Um PIX, vários gateways. Nenhuma cobrança perdida.

Integre uma vez com o Pagaki e distribua suas cobranças entre Asaas e Efí por regra. Se um gateway cair, o próximo assume sem você mudar uma linha.

  • API REST com OpenAPI
  • Sandbox separado
  • Webhooks assinados
Seu sistema POST /v1/payments
Pagaki Regra: PIX até R$ 5 mil
Efí · peso 30 Sem resposta em 2 s
Asaas · peso 70 Cobrança criada
Situação
Pago
Valor
R$ 150,50
Tentativas
2, com fallback

Como funciona

Do pedido ao dinheiro na conta, em quatro passos

  1. Passo 1: Você cria a cobrança

    Uma chamada POST /v1/payments com valor e pagador. Sem escolher gateway.

  2. Passo 2: O Pagaki escolhe o gateway

    Pelas suas regras: divide por peso (70% Asaas, 30% Efí) ou segue uma ordem de prioridade, por método e faixa de valor.

  3. Passo 3: Se falhar, tenta o próximo

    Gateway fora do ar, lento ou no limite: a cobrança é criada no seguinte da regra, e o QR Code volta para você.

  4. Passo 4: Você recebe o resultado

    Pago, expirado ou recusado: o mesmo evento assinado chega por webhook, seja qual for o gateway que atendeu.

  • Vários gateways, uma integração

    O mesmo objeto de pagamento e os mesmos eventos, seja qual for o gateway que criou a cobrança.

  • Fallback automático

    Cada tentativa fica registrada, com latência e erro, no detalhe do pagamento.

  • Regras que você controla

    Peso ou prioridade por método e faixa de valor, publicadas em versões. Troque a rota sem mexer no seu sistema.

Segurança

Feito para ficar entre o seu sistema e o dinheiro

As mesmas regras valem para todo cliente, sem configuração extra.

  • OAuth2 com token de 1 hora Client credentials por integração, revogáveis no painel.
  • Só os seus IPs chamam a API Lista de IPs permitidos por cliente. Lista vazia bloqueia tudo.
  • Dados do pagador criptografados CPF, e-mail e telefone guardados criptografados e devolvidos mascarados.
  • Nenhuma cobrança em dobro Idempotency-Key obrigatória em toda criação, válida por 24 horas.
  • Webhooks assinados HMAC-SHA256 com proteção contra repetição e segredo próprio por endpoint.

Preços

Preço sob medida para o seu volume

Não temos tabela pública. O valor é combinado com o time de vendas, a partir do seu volume mensal e dos gateways que você usa.

Falar com vendas Respondemos no e-mail que você informar.

Perguntas frequentes

O que perguntam antes de integrar

O dinheiro passa pelo Pagaki?
Não. Cada gateway é instalado com as suas credenciais, e o PIX cai na sua conta do gateway. O Pagaki decide para onde vai cada cobrança e acompanha o resultado.
E se o gateway não responder?
A API espera até 5 segundos. Sem resposta, devolve a cobrança como Processando, consulta o gateway de novo e, se ele não criou nada, tenta o próximo da regra. O resultado chega por webhook.
Quais gateways estão disponíveis?
Asaas e Efí, para PIX. Boleto e cartão estão planejados, no mesmo formato de pagamento da API.
Dá para usar o PIX recebido para pagar uma conta?
Sim, como recurso opcional. Ao criar o PIX você informa o boleto; quando o PIX é pago, o Pagaki paga o boleto pelo Pague Contas do Asaas. Se falhar, você decide: tentar de novo ou cancelar.
Dá para testar antes de ir para produção?
Sim. O sandbox é um ambiente separado, com banco próprio, que usa os sandboxes oficiais dos gateways.
Como sei que o webhook veio do Pagaki?
Todo webhook vem assinado com HMAC-SHA256 no cabeçalho Pagaki-Signature, com o horário do envio. Recuse o que tiver mais de 5 minutos ou assinatura que não confere.

Contato

Conte como você recebe hoje

Respondemos com o que o Pagaki resolve no seu caso e como ligar o sandbox.

Usamos estes dados só para responder ao seu contato.