Contestações (MED e chargeback)

Às vezes o cliente pede o dinheiro de volta pelo banco, sem falar com você:

MED (Mecanismo Especial de Devolução): no Pix, quando o cliente diz que caiu num golpe ou não recebeu o que comprou.
Chargeback: no cartão, quando o cliente não reconhece a compra.

Nos dois casos existe um prazo para você mostrar que a venda é legítima. Se ninguém responde, o dinheiro volta para o cliente.

Onde aparece

Em Contestações no painel, com as abertas no topo e ordenadas pelo prazo. A página inicial também avisa quando tem alguma esperando resposta, e o pagamento ganha um aviso com o botão Responder.

Pela API, GET /v1/disputes?status=open. E pelos avisos dispute.created, dispute.updated e dispute.closed.

Como cada conta trata

Nem toda conta avisa contestações pela API. Algumas cuidam de tudo no próprio painel; nesses casos a SuyPay mostra, em Contestações, onde responder, e marca o pagamento como devolvido se o dinheiro voltar ao cliente.

Conta	Aviso na SuyPay	Responder pela SuyPay	O que a defesa aceita
Stripe	chargeback	sim	texto e links
Woovi	MED	sim	texto (até 500) e pelo menos um link
ClownPay	MED	sim	texto (10 a 3.000) e de 1 a 10 links
Wyvi Pay	MED	sim	só texto, de 20 a 1.000 caracteres, sem links
Efí	MED (a SuyPay consulta todo dia e ao abrir Contestações)	sim	texto de 20 a 1.000 caracteres
Mercado Pago	chargeback	não, responda no painel do Mercado Pago
Asaas	chargeback	não, responda no painel do Asaas
Appmax	chargeback	não, responda no painel da Appmax
InvictusPay	MED e chargeback	não, responda no painel da InvictusPay
Pagar.me	chargeback perdido	não, a defesa é no painel do Pagar.me
Inter, EvoPay, TriboPay, RivooPay, Pagmaster	não avisam pela API	responda no painel da conta

Para os avisos chegarem, o endereço de avisos da conta precisa estar cadastrado nela com os eventos de contestação. Veja Conectar contas. Na Efí, a aplicação precisa dos escopos gn.infractions.read e gn.infractions.write; na Wyvi Pay, a chave precisa de disputa:responder.

A defesa é uma só por contestação na maioria das contas: depois de enviada, não dá para corrigir. A SuyPay confere o tamanho do texto e os links de acordo com a conta antes de mandar.

Responder

Conte o que foi vendido, quando foi entregue e para quem, com número do pedido, nota ou rastreio. Nas contas que aceitam links, junte links públicos das provas: nota fiscal, comprovante de entrega, conversa. Na Wyvi Pay, descreva as provas só no texto: ela recusa qualquer link.

curl https://api.suypay.com/v1/disputes/dp_.../evidence \
  -H "Authorization: Bearer suy_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Plano anual comprado em 12/10. O cliente acessou 8 vezes e recebeu a nota fiscal por e-mail.",
    "urls": ["https://sualoja.com/nf/1042.pdf"]
  }'

Situações

`status`	Quer dizer
`open`	esperando a sua resposta
`under_review`	resposta enviada, o banco está analisando
`won`	você ganhou, o dinheiro fica com você
`lost`	o dinheiro voltou para o cliente. O pagamento passa para `refunded`
`canceled`	o cliente desistiu da contestação

Testar

No modo de teste, abra um pagamento já pago da conta de teste e clique em Simular contestação.