Skip to main content
type distingue los reportes de fraude (early_fraud_warning), los avisos previos a una disputa (dispute_alert) y los casos de Visa RDR que la red ya cerró mediante un reembolso (rapid_dispute_resolution). Usa la API de Dispute alerts para listar las alertas de una cuenta, filtrarlas por tipo o por pago, y leer actionable para ver si un reembolso todavía puede evitar el contracargo.

Endpoints

Atributos

string
requerido
ID de la alerta de disputa, con el prefijo dspa_.
string | null
requerido
La cuenta a la que pertenece el pago alertado, con el prefijo biz_. null mientras la alerta no está asociada.
number
requerido
El importe alertado, en unidades enteras de currency. Es lo que informó el emisor, que puede diferir del importe del propio pago.
boolean
requerido
Si Whop reembolsó automáticamente el pago alertado. Refleja el pago, por lo que puede ser true para un reembolso emitido por otro flujo (RDR, resolución) sobre el mismo pago.
string | null
requerido
La red de la tarjeta tal como la informó el emisor, en minúsculas, como visa o mastercard. unknown cuando el reporte no incluye ni una red ni un BIN reconocible.
string | null
requerido
Lo que alega el titular de la tarjeta. fraud cuando dice que no realizó el pago: siempre para un early_fraud_warning, y para alertas de fraude de Ethoca y casos de Visa RDR presentados con un motivo de fraude. customer_dispute cuando realizó el pago pero lo disputa, como un producto no recibido o una suscripción cancelada. null cuando la alerta no incluye ninguna reclamación, como una solicitud del emisor de documentos de la transacción.Opciones disponibles: fraud, customer_dispute
string
requerido
Cuándo recibió Whop la alerta, como marca de tiempo ISO 8601.
string
requerido
Código de moneda ISO de tres letras del importe alertado.
object | null
requerido
La tarifa de alerta 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 alerta por esta. Siempre false para early_fraud_warning, por la que a Whop no se le factura y que nunca repercute.
string | null
requerido
Obsoleto: siempre null fuera del propio panel de Whop. Nombre del banco que emitió la tarjeta y presentó el reporte. OBSOLETO: siempre null fuera del propio panel de Whop.
string | null
requerido
El pago que informó el emisor, con el prefijo pay_. null cuando Whop no pudo asociar el reporte a un pago.
string | null
requerido
El producto por el que se realizó el pago alertado, con el prefijo prod_.
string
requerido
Cuándo presentó el emisor el reporte, como marca de tiempo ISO 8601. Anterior a created_at, que es cuando Whop lo recibió.
string | null
requerido
El programa de la red que envió la alerta, que type por sí solo no distingue. ethoca para Mastercard Ethoca, cdrn para Visa Verifi CDRN, rdr para Visa RDR, tc40 / safe para un reporte de fraude de Visa / Mastercard, paypal para una alerta de PayPal. null cuando la red no lo indicó.Opciones disponibles: ethoca, cdrn, rdr, tc40, safe, paypal
string | null
requerido
Cuándo se realizó la transacción informada, como marca de tiempo ISO 8601; si el propio reporte del emisor no la incluía, se usa la fecha en que se realizó el pago asociado. No debería ser null en la práctica; trata un valor nulo como un problema de datos y no como un comportamiento esperado.
string
requerido
Lo que envió el emisor. early_fraud_warning es un reporte de fraude sobre un pago liquidado (Visa TC40 / Mastercard SAFE): un reembolso todavía evita el contracargo y Whop nunca cobra una tarifa por ello. dispute_alert es un aviso previo a una disputa de la red de alertas del emisor, que Whop paga y repercute como tarifa. rapid_dispute_resolution es un caso de Visa RDR que la red ya cerró reembolsando el pago: no queda nada por hacer.Opciones disponibles: early_fraud_warning, dispute_alert, rapid_dispute_resolution
string
requerido
Cuándo cambió la alerta por última vez, como marca de tiempo ISO 8601.
DisputeAlert