Ir a contenido
Crea una cuenta
o
Inicia sesión
Logotipo de Stripe Docs
/
Pregúntale a la IA
Crear una cuenta
Iniciar sesión
Empieza ahora
Pagos
Ingresos
Plataformas y marketplaces
Gestión del dinero
Recursos para desarrolladores
Resumen
Acerca de Stripe Payments
Actualiza tu integración
Análisis de pagos
Pagos electrónicos
ResumenEncuentra tu caso de usoPagos administrados
Usa Payment Links
Crea una página del proceso de compra
Desarrolla una integración avanzada
Desarrolla una integración en la aplicación
Métodos de pago
Agrega métodos de pago
Gestiona los métodos de pago
Finalización de compra más rápida con Link
Interfaces de pago
Payment Links
Checkout
Elements para la web
Elements en la aplicación
Escenarios de pago
Administrar varias monedas
Flujos de pago personalizados
Capacidad adquirente flexible
Orquestación
Pagos en persona
Terminal
Más allá de los pagos
Constituye tu empresa
Criptomonedas
Financial Connections
Climate
Comprender el fraude
Protección contra fraudes de Radar
Gestionar disputas
    Resumen
    Cómo funcionan las disputas
    Gestión
    Responder a las disputas
    Gestiona las disputas mediante programación
      Visa Compelling Evidence 3.0
      Cumplimiento de la normativa de Visa
    Revocaciones de disputas
    Listas de comerciantes de alto riesgo
    Análisis
    Cómo medir las disputas
    Programas de monitoreo
    Optimización
    Prevención de disputas
    Smart Disputes
Verificar identidades
InicioPagosManage disputes

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:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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.

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_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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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.

Consulta también

  • Categorías de disputas
  • Medición de disputas
  • Cómo prevenir las disputas y el fraude
¿Te fue útil esta página?
SíNo
  • ¿Necesitas ayuda? Ponte en contacto con soporte.
  • Únete a nuestro programa de acceso anticipado.
  • Echa un vistazo a nuestro registro de cambios.
  • ¿Tienes alguna pregunta? Contacto.
  • ¿LLM? Lee llms.txt.
  • Con tecnología de Markdoc