Skip to main content
Incluye el pago disputado, una fecha límite para responder, tu evidencia y el resultado una vez que el procesador resuelve. Usa la API de Disputes para listar disputas, editar el paquete de evidencia mientras una disputa todavía se puede impugnar y enviarlo para revisión, o aceptar un contracargo que no quieras impugnar.

Endpoints

Atributos

string
requerido
ID de la disputa, con el prefijo dspt_.
boolean
requerido
Si la disputa puede concederse al cliente con POST /disputes/\{id} /accept. Verdadero solo para un contracargo que aún espera respuesta, antes de evidence_due_at, cuyo procesador de pagos admite aceptar disputas. Las consultas nunca se pueden aceptar.
string | null
requerido
La cuenta contra la que se presentó la disputa, con el prefijo biz_.
number
requerido
El importe disputado, en unidades enteras de currency.
object
requerido
El cliente que presentó la disputa.

Propiedades

string | null
requerido
La dirección de correo electrónico del cliente. Requiere el scope member:email:read; null sin él.
string | null
requerido
La fila de miembro del cliente en la cuenta, con el prefijo mem_.
string | null
requerido
El nombre para mostrar del cliente.
string | null
requerido
El ID de usuario del cliente, con el prefijo user_. null para un checkout como invitado.
string | null
requerido
El nombre de usuario de Whop del cliente.
string
requerido
Cuándo se abrió la disputa, como marca de tiempo ISO 8601.
string
requerido
Código de moneda ISO de tres letras del importe disputado.
object
requerido
El paquete de evidencia enviado al procesador para impugnar la disputa.

Propiedades

string | null
requerido
Registro del acceso del cliente al producto, como actividad de inicio de sesión o de descarga.
string | null
requerido
La dirección de facturación que proporcionó el cliente en el checkout.
object | null
requerido
El documento de la política de cancelación. De forma predeterminada, se usa la política de cancelación de la cuenta, luego sus términos de servicio, luego su política de devoluciones y luego la política de la plataforma de Whop.

Propiedades

string | null
requerido
El ID del adjunto. null para una política alojada por Whop, que no es un archivo subido.
string | null
requerido
El tipo MIME del archivo subido.
string | null
requerido
El nombre del archivo subido.
boolean
requerido
Si se trata de la política alojada por el propio Whop, que se usa en su lugar porque el vendedor no subió ninguna. Devolverla en un PATCH no cambia nada.
string | null
requerido
Una URL para descargar el adjunto.
string | null
requerido
Cómo se mostró la política de cancelación al cliente antes de la compra.
object | null
requerido
Correspondencia con el cliente, o prueba de que usó el producto.

Propiedades

string | null
requerido
El ID del adjunto. null para una política alojada por Whop, que no es un archivo subido.
string | null
requerido
El tipo MIME del archivo subido.
string | null
requerido
El nombre del archivo subido.
boolean
requerido
Si se trata de la política alojada por el propio Whop, que se usa en su lugar porque el vendedor no subió ninguna. Devolverla en un PATCH no cambia nada.
string | null
requerido
Una URL para descargar el adjunto.
string | null
requerido
La dirección de correo electrónico que usó el cliente en el checkout.
string | null
requerido
El nombre del cliente tal como lo indicó en el checkout.
object[]
requerido
Documentos de evidencia adicionales, más allá de los cuatro espacios fijos; se establecen mediante evidence.documents en PATCH /disputes/\{id}. Cada uno se incluye en el paquete enviado bajo su document_type.

Propiedades

string
requerido
El ID del archivo, con el prefijo file_.
string | null
requerido
Marcador de posición BlurHash para una imagen o un video. Null cuando no está disponible o fue eliminado por moderación.
string | null
requerido
El tipo MIME del archivo subido. Las subidas están restringidas a los tipos que acepta el procesador y se rechazan si no tienen uno; nunca es null.Opciones disponibles: application/pdf, application/json, image/jpeg, image/png, image/webp
string
requerido
Cuándo se creó el archivo, como marca de tiempo ISO 8601.
string
requerido
Lo que demuestra este documento. return_policy, cancellation_policy y terms_of_service son los documentos de políticas del vendedor. Un documento de política reemplaza la copia de la cuenta para esta disputa. return_policy, cancellation_policy y customer_communication también reemplazan el espacio de evidencia fijo correspondiente. shipping_policy son las condiciones de envío del vendedor. customer_communication es la correspondencia con el comprador, como un hilo de soporte o un registro de chat. product_image es una foto del producto o servicio que recibió el comprador. physical_fulfillment es la prueba de que un pedido físico se envió y llegó. digital_fulfillment es la prueba de que el comprador accedió a un producto digital. customer_order_history son los pedidos anteriores del comprador con este vendedor. prior_transactions es el historial de pagos del comprador en toda la plataforma, para una defensa contra fraude. customer_session son los datos del checkout, como la dirección IP, la huella del dispositivo, los resultados de AVS y CVV y el resultado de 3D Secure. subscription es la evidencia del ciclo de vida de la membresía, como renovaciones, cancelación y recordatorios enviados. complete_evidence es la respuesta completa del vendedor como un único PDF de 19 páginas como máximo, y debe ser el único documento. Whop envía un documento complete_evidence al procesador en lugar de todos los demás campos de evidencia, adjuntos y documentos.Opciones disponibles: return_policy, shipping_policy, cancellation_policy, terms_of_service, physical_fulfillment, customer_order_history, product_image, prior_transactions, customer_session, digital_fulfillment, subscription, customer_communication, complete_evidence
number | null
requerido
Duración del audio o video en segundos. Null cuando no está disponible o fue eliminado por moderación.
string | null
requerido
El nombre de archivo original, incluida su extensión.
integer | null
requerido
Altura de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.
integer | null
El tamaño en bytes que debe tener cada parte (excepto la última). Presente solo al crear y solo para subidas multiparte.
string | null
El ID de la subida multiparte, que se devuelve a complete. Presente solo al crear y solo para subidas multiparte.
object[] | null
La URL prefirmada de cada parte. Presente solo al crear y solo para subidas multiparte.

Propiedades

integer
requerido
El índice, empezando en 1, de esta parte dentro de la subida multiparte.
string
requerido
La URL prefirmada a la que hacer PUT de los bytes de esta parte.
string
requerido
El tipo de este objeto, siempre file.
boolean
requerido
Si la moderación eliminó el archivo. Cuando es true, url sirve una imagen de reemplazo. filename, size y content_type siguen describiendo el archivo original.
integer | null
requerido
El tamaño del archivo en bytes. null hasta que termina la subida.
object
Encabezados que se deben enviar con el PUT de la subida. Presente solo al crear.
string
requerido
En qué punto de su ciclo de vida de subida se encuentra el archivo.Opciones disponibles: pending, processing, ready, failed
string | null
URL prefirmada a la que hacer PUT de los bytes del archivo. Presente solo al crear y solo para subidas de una sola parte.
string | null
requerido
Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los privados una URL firmada que caduca. null hasta que termina la subida. Cuando la moderación elimina el archivo, una URL de imagen de reemplazo.
string
requerido
Los archivos public se sirven desde una URL de CDN sin firmar. Los archivos private se sirven desde una URL firmada que caduca.Opciones disponibles: public, private
string | null
requerido
URL de la forma de onda del audio. Null cuando no está disponible o fue eliminada por moderación.
integer | null
requerido
Ancho de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.
string | null
requerido
Cualquier contexto adicional para el procesador que revisa la disputa.
string | null
requerido
Lo que compró el cliente, en palabras del propio vendedor.
object | null
requerido
El documento de la política de reembolsos. De forma predeterminada, se usa la política de devoluciones de la cuenta, luego sus términos de servicio y luego la política de la plataforma de Whop.

Propiedades

string | null
requerido
El ID del adjunto. null para una política alojada por Whop, que no es un archivo subido.
string | null
requerido
El tipo MIME del archivo subido.
string | null
requerido
El nombre del archivo subido.
boolean
requerido
Si se trata de la política alojada por el propio Whop, que se usa en su lugar porque el vendedor no subió ninguna. Devolverla en un PATCH no cambia nada.
string | null
requerido
Una URL para descargar el adjunto.
string | null
requerido
Cómo se mostró la política de reembolsos al cliente antes de la compra.
string | null
requerido
Por qué se rechazó un reembolso, cuando se solicitó y se denegó.
string | null
requerido
Cuándo se entregó el producto o servicio.
object | null
requerido
Evidencia de respaldo que no encaja en las demás categorías.

Propiedades

string | null
requerido
El ID del adjunto. null para una política alojada por Whop, que no es un archivo subido.
string | null
requerido
El tipo MIME del archivo subido.
string | null
requerido
El nombre del archivo subido.
boolean
requerido
Si se trata de la política alojada por el propio Whop, que se usa en su lugar porque el vendedor no subió ninguna. Devolverla en un PATCH no cambia nada.
string | null
requerido
Una URL para descargar el adjunto.
string | null
requerido
La fecha límite para enviar evidencia, como marca de tiempo ISO 8601. null cuando la red ya resolvió automáticamente la disputa (Visa RDR) sin ronda de evidencia, o cuando el procesador no ha informado una fecha límite para esta disputa.
boolean
requerido
Si evidence todavía se puede cambiar y enviar.
string | null
requerido
Por qué ya no se puede editar la evidencia. null mientras evidence_editable es true.Opciones disponibles: submitted, response_window_closed, not_contestable
string | null
requerido
Cuándo se envió la evidencia al procesador, como marca de tiempo ISO 8601.
object | null
requerido
La tarifa de disputa cobrada a la cuenta, en la moneda en la que se cobró. null cuando fee_charged es false.

Propiedades

string
requerido
El importe en unidades principales, como una cadena decimal exacta. Por ejemplo, "10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
string
requerido
Código de moneda ISO 4217 de tres letras, en minúsculas.
integer
requerido
Cuántos decimales lleva el importe. Es la precisión con la que se ejecuta el propio cargo.
integer
requerido
Cuántos decimales MOSTRAR. Normalmente es igual a decimals, y deliberadamente no siempre: el COP se cobra en centavos pero se escribe en pesos enteros, así que es 2 y 0. Usa este valor para formatear el número en tu propia configuración regional.
boolean
requerido
Si Whop cobró a la cuenta una tarifa de disputa por esta. false cuando el pago se reembolsó por completo antes de abrirse la disputa, para una resolución de Visa RDR y para una consulta.
boolean
requerido
Si se trata de una consulta previa a la disputa y no de un contracargo formal. Las consultas siguen el mismo ciclo de vida, pero no mueven fondos a menos que escalen.
object[]
requerido
Lo que dijo el emisor de la tarjeta al presentar la disputa. Solo se rellena cuando el emisor lo proporciona, y se lista en el orden en que se recibió.

Propiedades

string | null
requerido
Cuándo se recibió el comentario, como marca de tiempo ISO 8601.
string
requerido
Lo que escribió el emisor, tal como se recibió.
object[]
requerido
Todo lo que cobró el pago disputado, en orden de compra. product_id y variant_id nombran el primero de estos; los artículos posteriores de un carrito solo aparecen aquí. Un pago realizado antes de que se registraran los artículos lista el único artículo que implica su variante. Vacío cuando el pago no está vinculado a una variante.

Propiedades

string | null
requerido
ID de la partida, con el prefijo li_. Null cuando el pago es anterior a las instantáneas de artículos y el artículo se lee de la variante del pago.
string | null
requerido
El nombre del artículo tal como se mostró en el checkout (el título del producto o, si no, el título de la variante).
string | null
requerido
El producto al que pertenece la variante, con el prefijo prod_. En un pago anterior a las instantáneas de artículos, se usa el producto de la variante, por lo que puede estar establecido cuando el propio product_id del padre es null. Null para una variante sin producto.
string | null
requerido
El título actual del producto, o null cuando el artículo no tiene producto.
number
requerido
Cuántas unidades se compraron.
string | null
requerido
El código de referencia (SKU) de la variante, texto libre establecido por el vendedor (p. ej., TSHIRT-LARGE-BLUE). Las cuentas con sufijos de SKU por motivo de facturación habilitados lo reciben marcado con el motivo del cargo: -S para un primer cargo de suscripción, -R para una renovación, -C para una compra única, -U cuando los propios metadatos del pago incluyen upsell: true, -F cuando no se cobró nada. Otros motivos de facturación llevan el SKU sin sufijo. null cuando la variante no tiene SKU o se ha eliminado.
object | null
requerido
El importe registrado para la cantidad completa de este artículo, antes de descuentos, impuestos y tarifas, en su moneda de compra. Devuelve null cuando no se registró ningún importe para el artículo.

Propiedades

string
requerido
El importe en unidades principales, como una cadena decimal exacta. Por ejemplo, "10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
string
requerido
Código de moneda ISO 4217 de tres letras, en minúsculas.
integer
requerido
Cuántos decimales lleva el importe. Es la precisión con la que se ejecuta el propio cargo.
integer
requerido
Cuántos decimales MOSTRAR. Normalmente es igual a decimals, y deliberadamente no siempre: el COP se cobra en centavos pero se escribe en pesos enteros, así que es 2 y 0. Usa este valor para formatear el número en tu propia configuración regional.
string | null
requerido
La variante comprada, con el prefijo plan_. Null cuando la variante se ha eliminado desde entonces.
string | null
requerido
El título actual de la variante, o null cuando la variante se ha eliminado o no tiene título.
object
requerido
El pago que se disputa.

Propiedades

string
requerido
ID del pago, con el prefijo pay_.
number | null
requerido
Lo que se cobró al cliente, en unidades enteras de la moneda del pago.
string | null
requerido
Marca de la tarjeta, cuando el cliente pagó con tarjeta.
string | null
requerido
Últimos cuatro dígitos de la tarjeta, cuando el cliente pagó con tarjeta.
string
requerido
Cuándo se realizó el pago, como marca de tiempo ISO 8601.
string | null
requerido
Código de moneda ISO de tres letras del pago. Puede diferir de la moneda de la disputa cuando el procesador liquida en otra moneda.
object | null
requerido
El instrumento con el que se realizó este pago, preparado para mostrarse: el tipo de método, un nombre orientado al comprador, el conjunto de iconos estándar y los datos de la tarjeta, incluido el ID de transacción de red que la cuenta usa para la tarjeta, cuando se trató de una tarjeta. Null cuando el pago no indica ningún método.

Propiedades

object | null
requerido
Solo para pagos con tarjeta, Apple Pay y Google Pay: la red de la tarjeta, los últimos cuatro dígitos, el número de identificación del emisor, el vencimiento y el ID de transacción de red.

Propiedades

string | null
requerido
El identificador de red (visa, amex, …), coincidente con las entradas de card.networks y los métodos de pago con tarjeta guardados. Null cuando la bóveda no registró la red.
number | null
requerido
El mes de vencimiento de la tarjeta, del 1 al 12. Null cuando la bóveda no lo registró.
number | null
requerido
El año de vencimiento de cuatro dígitos de la tarjeta. Null cuando la bóveda no lo registró.
string | null
requerido
El número de identificación del emisor, también llamado BIN: los seis u ocho primeros dígitos de la tarjeta, que identifican al banco emisor. Null cuando el procesador no lo informó.
string | null
requerido
Los últimos cuatro dígitos de la tarjeta, cuando se capturaron.
string | null
requerido
El ID de transacción de red que esta cuenta usa para la tarjeta. Es el ID propio de esta cuenta, de su primer cargo o verificación con el cliente presente en la tarjeta, cuando Whop tiene uno. De lo contrario, es un ID de transacción de red anterior de esta tarjeta, que puede provenir de la transacción de otra cuenta o haber llegado con la tarjeta. Cítalo como la transacción previa en un cargo posterior iniciado por el comercio con esta tarjeta en esta cuenta. Null hasta que haya uno. Un webhook enviado cuando un pago se registra por primera vez puede llevar null, así que recupera el pago para leerlo.
string
requerido
Nombre del instrumento orientado al comprador: “Visa •••• 4242” cuando se mostró la tarjeta o, si no, el propio nombre del método (“Klarna”).
object
requerido
El conjunto de iconos estándar: formas cuadrada y de tarjeta, cada una en variantes de color claras y oscuras.

Propiedades

object
requerido
El mosaico con proporciones de tarjeta de crédito (48x30).

Propiedades

object
requerido
La variante de color para superficies oscuras.

Propiedades

string
requerido
Alternativa rasterizada al tamaño nativo de la forma.
string
requerido
Alternativa rasterizada a doble densidad.
string
requerido
Alternativa rasterizada a cuádruple densidad.
string
requerido
El archivo vectorial. Dale preferencia en cualquier lugar donde se renderice SVG.
object
requerido
La variante de color para superficies claras.

Propiedades

string
requerido
Alternativa rasterizada al tamaño nativo de la forma.
string
requerido
Alternativa rasterizada a doble densidad.
string
requerido
Alternativa rasterizada a cuádruple densidad.
string
requerido
El archivo vectorial. Dale preferencia en cualquier lugar donde se renderice SVG.
object
requerido
El mosaico cuadrado (32x32).

Propiedades

object
requerido
La variante de color para superficies oscuras.

Propiedades

string
requerido
Alternativa rasterizada al tamaño nativo de la forma.
string
requerido
Alternativa rasterizada a doble densidad.
string
requerido
Alternativa rasterizada a cuádruple densidad.
string
requerido
El archivo vectorial. Dale preferencia en cualquier lugar donde se renderice SVG.
object
requerido
La variante de color para superficies claras.

Propiedades

string
requerido
Alternativa rasterizada al tamaño nativo de la forma.
string
requerido
Alternativa rasterizada a doble densidad.
string
requerido
Alternativa rasterizada a cuádruple densidad.
string
requerido
El archivo vectorial. Dale preferencia en cualquier lugar donde se renderice SVG.
number | null
requerido
Solo métodos a plazos: en cuántos pagos se divide el cargo. Son datos, no texto: compón y traduce la etiqueta en el cliente.
string
requerido
El identificador del tipo de método de pago, p. ej., card, klarna, apple_pay.
string | null
requerido
Cómo pagó el cliente, como card o paypal.
string | null
requerido
Obsoleto: ya no se rellena. Siempre null. OBSOLETO: ya no se rellena. Siempre null.
string | null
requerido
El producto por el que se realizó el pago disputado, con el prefijo prod_.
string
requerido
Por qué dice el cliente que disputa, normalizado entre procesadores y redes de tarjetas. other cubre un motivo del procesador que Whop aún no ha categorizado.Opciones disponibles: fraudulent, unrecognized, declined_authorization, product_not_received, product_unacceptable, subscription_canceled, credit_not_processed, duplicate, processing_error, documentation_request, bank_cannot_process, other
string | null
requerido
El código de motivo sin procesar de la red de tarjetas o del procesador, como 10.4. Solo informativo: reason no se deriva de él.
string
requerido
needs_response espera evidencia (después de que un procesador rechazara una presentación, submission_failure_reason indica por qué); generating_response tiene evidencia en el procesador, aún no aceptada; under_review está con el procesador; won/lost son las resoluciones; prevented se liquida como lost. Los estados warning_ son los niveles de consulta. Pasado evidence_due_at, una disputa abierta informa under_review.Opciones disponibles: needs_response, warning_needs_response, under_review, warning_under_review, generating_response, won, lost, prevented, warning_closed
string | null
requerido
Por qué el procesador de pagos rechazó la última presentación, en lenguaje claro, mientras la disputa vuelve a estar en needs_response. Corrige lo que indica y envíala de nuevo. Solo al recuperar: dispute.updated informa el regreso a needs_response; luego lee este campo aquí.
string
requerido
Cuándo cambió la disputa por última vez, como marca de tiempo ISO 8601.
string | null
requerido
La variante en la que se realizó el pago disputado, con el prefijo plan_.
Dispute