Entenda como funcionam cobranças na API PayHub
Cobranças representam transações de pagamento na PayHub. Cada cobrança está associada a um método de pagamento e segue um ciclo de vida específico.
A API suporta os seguintes métodos:
| Método | Identificador | Descrição |
|---|---|---|
| Cartão de Crédito | credit_card | Pagamento com cartão de crédito, com suporte a parcelamento |
| Cartão de Débito | debit_card | Pagamento com cartão de débito, sem parcelamento |
| PIX | pix | Transferência instantânea via QR Code |
| Boleto | boleto | Boleto bancário com data de vencimento |
| Status | Descrição |
|---|---|
pending | Cobrança criada, aguardando processamento |
authorized | Pagamento autorizado (cartão de crédito ou débito) |
captured | Pagamento capturado/confirmado |
partially_refunded | Estornada parcialmente |
refunded | Estornada totalmente |
voided | Cancelada antes da captura |
failed | Falha no processamento |
expired | Expirada (PIX ou boleto não pago no prazo) |
authorized)captured)authorized)captured)Cobranças de cartão de débito não suportam parcelamento — o valor é sempre cobrado em parcela única.
capturedexpiredcapturedexpiredIndependente do método de pagamento, toda cobrança exige:
| Campo | Tipo | Descrição |
|---|---|---|
amount | integer | Valor em centavos (ex: R$ 100,00 = 10000) |
payment_method | string | Método de pagamento |
product_type | string | physical ou digital |
customer | object | Dados do cliente (nome, e-mail, CPF/CNPJ, telefone) |
items | array | Lista de itens do pedido |