Use a API para responder a contestações
Você pode responder a contestações no Stripe Dashboard, seguindo nossas orientações para enviar os comprovantes ideais para cada motivo de contestação.
Também é possível programar o gerenciamento de contestações pela API. Você pode carregar comprovantes, responder a contestações e receber eventos de contestações com webhooks.
Recuperar uma contestação
Para obter mais detalhes sobre uma contestação, recupere um objeto Dispute
:
A resposta contém informações sobre a contestação e todas as respostas ou comprovantes já fornecidos.
{ object: "dispute" id: "{{DISPUTE_ID}}", charge: "ch_5Q4BjL06oPWwho", evidence: { customer_name: "Jane Austen", customer_purchase_ip: "127.0.0.1", product_description: "Widget ABC, color: red", shipping_tracking_number: "Z01234567890", uncategorized_text: "Additional notes and comments", }, evidence_details: { due_by: 1403047735, submission_count: 1 } ... }
Atualizar uma contestação
Você atualiza o objeto Dispute
e passa comprovantes estruturados com o parâmetro evidence
.
Para ver todos os campos disponíveis para o parâmetro de comprovante, consulte Comprovante de contestação. Há dois tipos de comprovantes que você pode fornecer, dependendo do campo que está sendo atualizado:
- Comprovantes em texto, como
customer_email
eservice_date
. Esse tipo de comprovante é uma string de texto. - Comprovantes baseados em arquivos, como
service_documentation
ecustomer_communication
. Para esses, use o ID de objeto file_upload.
Observação
O limite de caracteres para a soma de todos os envios do campo de comprovantes é de 150.000.
Para fornecer documentos ou imagens (como contratos ou capturas de tela) como comprovantes para a contestação, use a API File Upload. Primeiro, você carrega um documento com a finalidade de dispute_evidence
, a qual gera um objeto File_upload
que você pode usar ao enviar comprovantes. Confira as recomendações da Stripe antes de enviar arquivos como comprovantes.
Se quiser enviar um único arquivo ou uma grande quantidade de texto simples como comprovante, use uncategorized_text
ou uncategorized_file
. No entanto, preencha o máximo de campos possível para ter a melhor chance de reverter uma contestação.
Observação
Você precisa usar o Dashboard para enviar comprovantes de contestações qualificadas para o Visa Compelling Evidence 3.0. Não oferecemos acesso a dados de transações anteriores via API.
Várias contestações em um único pagamento
Não é comum, mas um cliente pode contestar o mesmo pagamento mais de uma vez. Por exemplo, um cliente pode contestar parcialmente o pagamento de um dos itens em um pedido se ele foi danificado na entrega e, em seguida, registrar uma segunda contestação contra um item diferente no mesmo pedido porque o item não funcionou corretamente.
A Stripe distingue todas as contestações por um identificador único, independentemente de estarem relacionadas a um único pagamento. Quando você lista contestações, pode filtrar os resultados para mostrar somente contestações para um pagamento específico especificando o id
do PaymentIntent
ou Charge
e incluindo o filtro payment_intent ou filtro de cobrança.
Quando um pagamento tem várias contestações, use o id
fornecido para cada contestação retornada na lista para assegurar que está respondendo à contestação correta ao especificar id
quando você recupera ou atualiza a contestação.