Paygrid — orquestração de pagamentos
O Paygrid é um orquestrador de pagamentos: você integra uma vez com a nossa API e o Paygrid decide o caminho da cobrança (provedor de cobrança, antifraude, condições, aprovação/recusa) com base no fluxo que você configura.
O Paygrid não guarda dinheiro. O valor é processado pelo
provedor que você configurar (ex. Pagar.me); o Paygrid orquestra e reporta.
Como funciona
- Tenant — sua conta no Paygrid (empresa + usuário admin).
- Fluxo — o caminho da cobrança: provedor, antifraude, condição, aprovação/recusa.
- Provedor — a subconta do gateway que processa o pagamento.
- Cobrança — você cria via
POST /v1/transactions. - Webhook — o Paygrid notifica o desfecho (pago, recusado, estornado).
Conceitos-chave
| Conceito | O que é |
|---|---|
tenantId | Identificador da sua conta no Paygrid. |
transactionId | Identificador de cada cobrança criada. |
paymentId | Identificador público estável do pagamento (sobrevive a retentativas). |
Idempotency-Key | Cabeçalho que evita cobrança duplicada. |
providerTransactionId | Id da cobrança no gateway — usado para reconciliar. |
Status de uma cobrança
| Status | Significado |
|---|---|
pending | Aguardando o gateway confirmar. |
approved | Pagamento aprovado. |
declined | Pagamento recusado. |
refunded | Estornado. |
cancelled | Cancelado. |
pending_reconciliation | Resultado ambíguo — precisa análise antes de agir. |