Endpoints
Atributos
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.El cliente que presentó la disputa.
Propiedades
Propiedades
La dirección de correo electrónico del cliente. Requiere el scope
member:email:read; null sin él.El ID de usuario del cliente, con el prefijo
user_. null para un checkout como invitado.El paquete de evidencia enviado al procesador para impugnar la disputa.
Propiedades
Propiedades
Registro del acceso del cliente al producto, como actividad de inicio de sesión o de descarga.
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
Propiedades
El ID del adjunto.
null para una política alojada por Whop, que no es un archivo subido.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.
Correspondencia con el cliente, o prueba de que usó el producto.
Propiedades
Propiedades
El ID del adjunto.
null para una política alojada por Whop, que no es un archivo subido.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.
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
Propiedades
Marcador de posición BlurHash para una imagen o un video. Null cuando no está disponible o fue eliminado por moderación.
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/webpLo 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_evidenceDuración del audio o video en segundos. Null cuando no está disponible o fue eliminado por moderación.
Altura de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.
El tamaño en bytes que debe tener cada parte (excepto la última). Presente solo al crear y solo para subidas multiparte.
El ID de la subida multiparte, que se devuelve a
complete. Presente solo al crear y solo para subidas multiparte.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.En qué punto de su ciclo de vida de subida se encuentra el archivo.Opciones disponibles:
pending, processing, ready, failedURL prefirmada a la que hacer PUT de los bytes del archivo. Presente solo al crear y solo para subidas de una sola parte.
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.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, privateURL de la forma de onda del audio. Null cuando no está disponible o fue eliminada por moderación.
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
Propiedades
El ID del adjunto.
null para una política alojada por Whop, que no es un archivo subido.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.
Evidencia de respaldo que no encaja en las demás categorías.
Propiedades
Propiedades
El ID del adjunto.
null para una política alojada por Whop, que no es un archivo subido.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.
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.Por qué ya no se puede editar la evidencia.
null mientras evidence_editable es true.Opciones disponibles: submitted, response_window_closed, not_contestableLa tarifa de disputa cobrada a la cuenta, en la moneda en la que se cobró.
null cuando fee_charged es false.Propiedades
Propiedades
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.Cuántos decimales lleva el importe. Es la precisión con la que se ejecuta el propio cargo.
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.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.
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ó.
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
Propiedades
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.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).
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.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.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
Propiedades
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.Cuántos decimales lleva el importe. Es la precisión con la que se ejecuta el propio cargo.
La variante comprada, con el prefijo
plan_. Null cuando la variante se ha eliminado desde entonces.El pago que se disputa.
Propiedades
Propiedades
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.
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
Propiedades
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
Propiedades
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.El mes de vencimiento de la tarjeta, del 1 al 12. Null cuando la bóveda no lo registró.
El año de vencimiento de cuatro dígitos de la tarjeta. Null cuando la bóveda no lo registró.
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ó.
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.Nombre del instrumento orientado al comprador: “Visa •••• 4242” cuando se mostró la tarjeta o, si no, el propio nombre del método (“Klarna”).
El conjunto de iconos estándar: formas cuadrada y de tarjeta, cada una en variantes de color claras y oscuras.
Propiedades
Propiedades
El mosaico con proporciones de tarjeta de crédito (48x30).
Propiedades
Propiedades
La variante de color para superficies oscuras.
La variante de color para superficies claras.
El mosaico cuadrado (32x32).
Propiedades
Propiedades
La variante de color para superficies oscuras.
La variante de color para superficies claras.
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.
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, otherEl 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.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_closedPor 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í.Dispute

