Usa la API para responder las disputas

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

For details about a dispute, retrieve a Dispute object:

curl https://api.stripe.com/v1/disputes/
{{DISPUTE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

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.

curl https://api.stripe.com/v1/disputes/
{{DISPUTE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode "evidence[customer_email_address]"="email@example.com" \
  -d "evidence[shipping_date]"=2024-02-01 \
  -d "evidence[shipping_documentation]"=
{{FILE_ID}}

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_email y service_date. Estos tipos de evidencia requieren una cadena de texto.
• Evidencia basada en archivos, como service_documentation y customer_communication. Requieren un ID de objeto file_upload.

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_evidence como propósito, y eso genera un objeto File_upload 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_text o uncategorized_file. 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.

curl -G https://api.stripe.com/v1/disputes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent={{PAYMENT_INTENT_ID}}

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.