Usa la API para responder las disputas
Más información sobre cómo manejar las disputas mediante programación.
Puedes gestionar disputas mediante programación utilizando la API. Con la API, puedes subir evidencia, responder a disputas y recibir eventos de disputas utilizando webhooks.
Si deseas gestionar disputas utilizando el Dashboard en lugar de la API, consulta Responder a disputas.
Recupera una disputa
Para obtener más información sobre una disputa, recupera el objeto Dispute
:
La respuesta contiene información acerca de la disputa y toda respuesta o evidencia que ya se haya proporcionado.
{ 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 } ... }
Actualiza una disputa
Debes actualizar el objeto Dispute
y pasar la evidencia estructurada con el parámetro evidence
.
Para ver todos los campos disponibles para el parámetro evidence
, consulta Evidencia de disputa. Hay dos tipos de evidencia que puedes proporcionar, dependiendo del campo que se esté actualizando:
- Evidencia basada en texto, como
customer_
yemail service_
. Estos tipos de evidencia requieren una cadena de texto.date - Evidencia basada en archivos, como
service_
ydocumentation customer_
. Requieren un ID de objeto file_upload.communication
Nota
El total de caracteres combinados para todas las presentaciones de campos de evidencia basada en texto se limita a 150,000.
Puedes proporcionar documentos o imágenes (por ejemplo, un contrato o una captura de pantalla) como parte de la evidencia para una disputa usando la Carga del archivo en la API. En primer lugar, cargas un documento con dispute_
como propósito, y eso genera un objeto File_
que podrás utilizar para presentar la evidencia. Asegúrate de que el archivo cumpla con las recomendaciones de Stripe antes de cargarlo y enviarlo como evidencia.
Si solo te interesa presentar un único archivo o una gran cantidad de texto sin formato como evidencia, usa los parámetros uncategorized_
o uncategorized_
. Sin embargo, debes completar la mayor cantidad posible de campos para poder tener la mejor oportunidad de anular una disputa.
Múltiples disputas en un solo pago
Aunque no sucede con frecuencia, es posible que un cliente dispute el mismo pago más de una vez. Por ejemplo, un cliente puede disputar parcialmente el pago de uno de los artículos de un pedido si se dañó durante la entrega, y luego presentar una segunda disputa por un artículo diferente del mismo pedido debido a que no funcionó correctamente.
Stripe distingue todas las disputas por un identificador único, independientemente de si están relacionadas con un solo pago. Cuando enumeras disputas, puedes filtrar los resultados para mostrar solo disputas para un pago particular especificando el id
del objeto PaymentIntent
o Charge
e incluyendo el filtro payment_intent o charge.
Cuando un pago tiene varias disputas, usa la id
proporcionada para cada disputa que aparece en la lista. De esta manera, te asegurarás de que estás respondiendo a la disputa correcta. Para eso, especifica su id
cuando recuperas o actualizas la disputa.