Pagar.me, chargebacks e disputas
Recebíveis no Pagar.me, transferência automática, chargebacks e disputas do seller.
Duas perguntas financeiras do seller: "quando o dinheiro das vendas chega?" e "e se o cliente contestar?". A primeira é respondida pelas rotas do Pagar.me; a segunda pelas centrais de chargeback e de disputas.
Como funciona
- O dinheiro das vendas
Com o Pagar.me, cada venda gera um recebível que cai na conta do seller no prazo do gateway. Consulte saldo e recebíveis.
- O cliente reclama
Ou ele abre uma disputa na loja (resolvida entre as partes) ou contesta com o banco (chargeback).
- O seller reage no prazo
Na disputa, o seller tem 48 horas para propor uma solução. No chargeback, 7 dias para enviar a defesa.
Conceitos-chave
Pagar.me e o recebedor
O Pagar.me é um dos gateways de pagamento da plataforma. Com divisão automática, o seller é cadastrado lá como recebedor e o dinheiro das vendas vai direto a ele. As rotas pagarme/* não leem o banco da plataforma: elas consultam o Pagar.me ao vivo, então dependem dele estar no ar.
Chargeback versus disputa
Chargeback é uma contestação feita pelo cliente ao banco do cartão; o prazo e o resultado vêm do gateway. Disputa é uma reclamação feita dentro da loja, sem banco; quem decide são comprador, seller e, se escalada, a loja.
Dinheiro e ids
Valores inteiros em centavos. Casos de chargeback e disputas usam UUID; os ids do Pagar.me são os dele (números ou textos como rp_...).
Acesso
As rotas do Pagar.me exigem o módulo pagarme e o privilégio financeiro. Chargebacks e disputas exigem só ser seller.
Endpoints
| Método | Caminho | Para que serve | Autenticação | Página |
|---|---|---|---|---|
| GET | /api/v1/vendor/pagarme/summary | Resumo financeiro. | seller, financeiro, pagarme | Saldo e recebíveis |
| GET | /api/v1/vendor/pagarme/payables | Recebíveis. | seller, financeiro, pagarme | Saldo e recebíveis |
| GET | /api/v1/vendor/pagarme/settlements | Liquidações por dia. | seller, financeiro, pagarme | Saldo e recebíveis |
| GET | /api/v1/vendor/pagarme/schedule | Agenda de 7 ou 30 dias. | seller, financeiro, pagarme | Saldo e recebíveis |
| GET | /api/v1/vendor/pagarme/transfer | Lê a transferência automática. | seller, financeiro, pagarme | Transferência |
| PUT | /api/v1/vendor/pagarme/transfer | Altera a transferência automática. | seller, financeiro, pagarme | Transferência |
| GET | /api/v1/vendor/chargebacks | Lista casos. | seller | Chargebacks |
| GET | /api/v1/vendor/chargebacks/stats | Indicadores. | seller | Chargebacks |
| GET | /api/v1/vendor/chargebacks/{id} | Caso com dossiê. | seller | Chargebacks |
| PUT | /api/v1/vendor/chargebacks/{id} | Classifica e muda a situação. | seller | Chargebacks |
| GET | /api/v1/vendor/disputes | Lista disputas. | seller | Disputas |
| POST | /api/v1/vendor/disputes/{id}/respond | Envia a proposta. | seller | Disputas |
Erros comuns
- Chamar as rotas do Pagar.me sem recebedor:
409 pagarme_recipient_missing. A loja precisa vincular o seller antes. - Tratar
502 pagarme_upstreamcomo bug da plataforma. É o Pagar.me que falhou ou recusou a chave; o motivo está emdetail. - Mandar
PUT /pagarme/transfersó com um campo. Os três são substituídos; o que faltar vai como falso/zero. - Passar de 7 dias num chargeback sem enviar a defesa: o caso vira
expired. - Enviar
reasonouamount_centsnoPUTdo chargeback. É403 chargeback_fact_admin_only. - Responder uma disputa que já está
awaiting_buyer:400 cannot respond in status awaiting_buyer.