Usa la API para responder las disputas

Puedes responder a las disputas en el Dashboard de Stripe, donde te guiamos para que envíes la mejor evidencia para cada motivo de disputa.

También puedes gestionar las disputas mediante programación usando la API. Con la API, puedes cargar evidencia, responder a las disputas y recibir eventos de disputa con el uso de los webhooks.

Recupera una disputa

Para obtener más información sobre una disputa, recupera un objeto Dispute:

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

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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  --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 los parámetros de evidencia, consulta Evidencia de la disputa. Hay dos tipos de evidencia que puedes proporcionar, según el campo que estés 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. Este tipo de evidencia requiere el ID de objeto de 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 con un identificador único, independientemente de si están relacionadas con un solo pago. Cuando haces una lista de disputas, puedes filtrar los resultados para que muestren solo las disputas de un pago en particular. Para eso, especifica el id del objeto PaymentIntent o Charge e incluye el filtro payment_intent o el filtro charges.

curl -G https://api.stripe.com/v1/disputes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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.