Pagamentos
O que é um pagamento?
Um pagamento representa a transação de um cliente processada por meio da Global API da Getnet, independentemente do método de pagamento utilizado (cartão de crédito, cartão de débito, PIX, Boleto, Bizum ou outros métodos de pagamento alternativos).
Os pagamentos reúnem detalhes essenciais da transação, incluindo informações do cliente, valor total, moeda, método de pagamento, detalhes do pedido e muito mais. Cada pagamento pode ter uma ou mais transações associadas que determinam seu resultado final. Para uma compreensão mais profunda dos tipos de transação e como eles se relacionam com os pagamentos, consulte a página Transações.
Ciclo de Vida do Pagamento
O diagrama a seguir ilustra os possíveis status de pagamento e suas conexões ao longo do ciclo de vida do pagamento. Todo pagamento possui um status que segue um fluxo padronizado, garantindo funcionalidade consistente em todos os métodos de pagamento. Um pagamento passa por uma sequência de status até a conclusão. O diagrama abaixo mostra os possíveis resultados com base no processamento da transação.
[DIAGRAM_PLACEHOLDER: payment-lifecycle-flow.mermaid]
Status do Pagamento
Cada pagamento na Global API da Getnet pode ter um dos seguintes status:
| Status | Descrição |
|---|---|
| PENDING | O pagamento está sendo processado e aguardando um status final. Pode estar aguardando confirmação do provedor, verificação 3DS ou análise de fraude (fraud screening). |
| WAITING | O pagamento está aguardando a ação do cliente ou autenticação externa (por exemplo, autenticação 3DS, conclusão de redirecionamento). |
| APPROVED | O pagamento foi processado com sucesso e aprovado pelo emissor. Os fundos estão capturados ou disponíveis para captura. |
| DENIED | O pagamento foi rejeitado pelo emissor ou processador de pagamento (por exemplo, fundos insuficientes, cartão recusado, detecção de fraude). |
| ERROR | Ocorreu um erro no sistema durante o processamento do pagamento. |
| EXPIRED | O pagamento expirou antes da conclusão (por exemplo, tempo limite de autorização, janela de pagamento fechada). |
Após um pagamento ser APPROVED, você pode realizar operações pós-venda, como cancelamentos (estornos) ou reembolsos (totais ou parciais). Estas são operações de API separadas, não status de pagamento.
Para obter mais detalhes sobre códigos de status e status no nível da transação, consulte a página Transações e a Referência da API.
Pagamentos e Transações
Um pagamento consiste em uma ou mais transações que determinam seu resultado final. Ao habilitar recursos adicionais para o seu fluxo de pagamento — como autenticação 3D Secure, análise de fraude ou fluxos de autorização e captura — eles criam transações adicionais que se tornam parte do ciclo de vida do pagamento.
Principais relacionamentos:
- Pagamentos em etapa única (compra): Uma transação principal que cobra o cliente imediatamente
- Pagamentos em duas etapas (autorização e captura): Múltiplas transações — primeiro reservando os fundos, depois capturando-os
- Operações pós-venda: Transações adicionais para cancelamentos, reembolsos ou ajustes
Cada transação dentro de um pagamento tem seu próprio status que contribui para o status geral do pagamento. Por exemplo, um pagamento com status APPROVED pode conter várias transações: uma autorização aprovada, uma verificação de análise de fraude bem-sucedida e uma cobrança capturada.
Você pode consultar todas as transações associadas a um pagamento usando o endpoint Get Transaction. Isso retorna informações detalhadas sobre cada transação, incluindo seus status individuais, carimbos de data/hora (timestamps) e detalhes de processamento.
Veja também
Para guias de implementação detalhados e exemplos de código, consulte a seção Guias de Pagamento na documentação. Para entender os tipos de transação e como eles se relacionam com os pagamentos, consulte Transações. Para recursos de segurança e conformidade, consulte Tokenização, Autenticação 3DS 2.0, Verificação de Cartão e Conformidade PCI.