Pagamentos resilientes por padrão

Conecte múltiplos provedores, controle quanto tempo seu cliente espera no checkout, recupere pagamentos automaticamente e acompanhe cada decisão em uma única plataforma.

Controle o tempo de espera

Defina por quanto tempo o cliente aguardará a confirmação. Se o limite for atingido, a PlugToPay continua em segundo plano.

Fallback automático

Continue no próximo provedor quando houver uma falha recuperável, sem exigir outra tentativa do cliente.

Roteamento flexível

Distribua pagamentos por prioridade, percentual ou método de pagamento.

Observabilidade completa

Veja cada tentativa, o erro, a resposta e o tempo consumido por provedor.

Sandbox completo

Simule recusas com atraso de resposta em gateways específicos, e teste retentativas e fallback antes de processar dinheiro real.

Uma única integração

Centralize gateways, checkout, links de pagamento e recorrência em uma única API.

Integração tradicional:

Cliente → Checkout → Gateway → espera até a resposta final

Com a PlugToPay:

Cliente → Checkout → PlugToPay
                         ├─ resposta dentro do limite configurado
                         └─ processing → fallback → webhook final

Começar integração

Simular um fallback

Pagamentos não deveriam falhar apenas porque um provedor ficou indisponível. Seu cliente também não deveria permanecer vários segundos olhando para uma tela de carregamento enquanto gateways, adquirentes e bancos processam uma transação. A PlugToPay foi criada para separar a experiência do checkout das limitações da infraestrutura de pagamentos. Por meio de uma única integração, sua empresa pode conectar múltiplos provedores, configurar estratégias de roteamento, executar fallback automático, recuperar pagamentos e acompanhar cada etapa da transação.

Seu checkout continua rápido. Seus pagamentos continuam protegidos.

O problema

Numa integração tradicional, o checkout depende diretamente da resposta de um único provedor.

Cliente → Checkout → Gateway → Adquirente → Emissor → Resposta

Se qualquer parte dessa cadeia ficar lenta, o consumidor espera. Se o gateway falhar, a venda pode ser perdida. Se for necessário tentar outro provedor, o tempo de espera pode aumentar ainda mais. Além disso, quando algo dá errado, geralmente é difícil descobrir onde ocorreu a falha, qual gateway respondeu o quê, se o webhook foi entregue, ou se a venda poderia ter sido recuperada. A PlugToPay resolve esses problemas como parte da própria infraestrutura de orquestração.

Controle quanto tempo seu cliente espera

Com o Smart Checkout Response, sua empresa define o tempo máximo que o consumidor pode aguardar por uma resposta no checkout. Se o limite for ultrapassado, a PlugToPay retorna processing imediatamente e o resultado final chega por webhook — sem bloquear o checkout enquanto retentativas e fallback continuam em background.

Na documentação técnica, esse limite é o campo time_to_wait_sync. Referência completa em Configurações de orquestração.

Escolha a estratégia de resposta

Cada operação tem necessidades diferentes. Por isso a PlugToPay permite escolher, entre aguardar a confirmação ou responder de imediato (sync / async), qual delas melhor se encaixa no seu fluxo.

Recupere pagamentos automaticamente

Quando um gateway falha, fica indisponível ou retorna um erro recuperável, a PlugToPay continua o processamento em outro provedor — sem que o consumidor precise preencher novamente o checkout. Veja como funciona em Fallback.

Distribua pagamentos entre múltiplos provedores

Configure a distribuição por prioridade ou por percentual entre gateways, para reduzir dependência de um único provedor ou comparar desempenho. Veja Roteamento.

Entenda cada decisão

A PlugToPay não mostra apenas o status final de um pagamento — mostra como aquele resultado foi produzido. Cada transação registra, em transactions[], o gateway usado em cada tentativa, o código de resposta e quanto tempo aquela tentativa levou — além do tempo total, do tempo interno da PlugToPay e do tempo somado gasto nos gateways:

{
  "status": "approved",
  "total_request_time": "5.21s",
  "plugtopay_request_time": "0.08s",
  "gateways_request_time": "5.13s",
  "transactions": [
    { "attempt": 1, "gateway": "safe2pay", "status": "failed", "response_code": "51", "request_time": "2.10s" },
    { "attempt": 2, "gateway": "pagarme", "status": "approved", "response_code": "00", "request_time": "1.21s" }
  ]
}

Isso reduz o tempo necessário para investigar problemas e permite identificar claramente onde ocorreu uma falha ou lentidão. Veja Status das transações para o mapeamento completo.

Teste falhas antes da produção

O ambiente de sandbox permite validar não apenas pagamentos aprovados, mas também o comportamento da sua integração quando algo dá errado — por exemplo, enviando simulate_payment_fail para forçar uma recusa e testar sua lógica de retentativa e fallback (veja Pagamentos). Combine isso com Idempotência para validar reenvios seguros em redes instáveis, e com Webhooks para confirmar que sua aplicação trata corretamente a entrega assíncrona do resultado final. Assim, sua equipe consegue validar boa parte do fluxo de resiliência antes de processar dinheiro real.

Uma integração, múltiplas possibilidades

Com uma única integração, sua empresa pode utilizar múltiplos gateways, checkout, links de pagamento, assinaturas e cobrança recorrente, webhooks, roteamento, fallback e retentativas. As funcionalidades de resiliência não estão limitadas à API de pagamentos: links de pagamento e assinaturas criam transações através do mesmo mecanismo de processamento, então herdam automaticamente o roteamento e o fallback configurados na plataforma.

Construída para desenvolvedores

A PlugToPay oferece uma API REST documentada via OpenAPI, ambiente sandbox, idempotência, webhooks assinados, histórico de tentativas e payloads rastreáveis. O objetivo é que sua equipe consiga integrar, testar e diagnosticar pagamentos sem depender de comportamentos ocultos ou testes arriscados em produção.