Cobranças
Cobranças
O coração da API de cartão: você cria a cobrança, acompanha como ela evolui e, se precisar, devolve o valor inteiro ou só uma parte.
Cobranças são o núcleo da API de Cartão. Você cria a cobrança com os dados do cartão, acompanha o status e, se precisar, estorna o valor total ou parcial.
Quando usar cada um
| Pergunta | Endpoint |
|---|---|
| Quero cobrar o cartão de um cliente | POST /charges |
| Preciso de uma lista de cobranças, com filtros e paginação | GET /charges |
| Qual o estado atual de uma cobrança específica? | GET /charges/{chargeId} |
| Preciso devolver o dinheiro, total ou parcialmente | PUT /charges/{chargeId}/reverse |
O campo amount é sempre em centavos: 10000 significa R$ 100,00. Isso vale também para o parâmetro amount do estorno parcial.
Exemplo
Recursos da cobrança
O POST /charges também aceita variações do fluxo básico: