Skip to main content
Un pago fraudulento te cuesta el dinero, una comisión por disputa de $15 y empeora tu tasa de disputas. Whop analiza los checkouts con sus propios controles de fraude. Las reglas de pago añaden tu propia capa por encima: condiciones que tú escribes y una acción que Whop ejecuta cuando un checkout las cumple todas. Las reglas se ejecutan después de los controles de Whop y nunca los relajan. Un pago que Whop bloquea sigue bloqueado.

Cuatro formas en que puede actuar una regla

Una regla puede leer risk_score, amount_in_usd, card_country, card_bin, customer_email e ip_address. card_bin es el número de identificación bancaria (BIN) de la tarjeta usada para el pago: los seis primeros dígitos del número de tarjeta. List fields devuelve los operadores y valores que acepta cada uno. Cuando tengas dudas, pide verificación en lugar de bloquear. Un bloqueo también rechaza a compradores reales que coinciden, mientras que una verificación les permite demostrar que son los titulares de la tarjeta.
Ejecuta estos ejemplos en un entorno de servidor de confianza con WHOP_API_KEY configurada. Reutiliza las importaciones y la configuración del cliente del primer ejemplo para tu lenguaje.

Bloquea el fraude evidente

Empieza por el patrón que más ves en tus disputas. Esta regla bloquea un pago al que Whop asigna una puntuación de 85 o más con una tarjeta emitida fuera de EE. UU.
Pasa siempre account_id. Sin él, la regla se aplica a la cuenta predeterminada de tu credencial, lo que es fácil de confundir en una plataforma que gestiona varias. Las reglas se publican en el checkout cada minuto, así que una regla nueva o modificada empieza a aplicarse en un par de minutos.
Permiso requerido: payment:manage para escribir reglas, payment:basic:read para leerlas. Añade permisos siguiendo la guía de permisos.

Pide verificación en los pedidos grandes

Un pedido grande con una tarjeta robada es el contracargo que menos quieres. Un pedido grande de un cliente real es la venta que menos quieres perder. Una verificación 3D Secure distingue entre ambos, y el pago registra three_ds_verified: true cuando el comprador la supera. enforce_3ds se omite, aunque se sigue registrando en el pago, cuando el checkout no admite una verificación. Esto incluye los pagos fuera de sesión, como las renovaciones, las variantes que definen su propio nivel de 3D Secure, los pagos que no son con tarjeta y las tarjetas que el procesador no puede verificar. American Express solo se verifica en pagos en USD.

Revisa un pago antes de cobrarlo

Una regla review autoriza un pago con tarjeta elegible sin capturarlo. El comprador completa el checkout y obtiene acceso a la membresía en el momento de la autorización. Úsala para pedidos que gestionas a mano o para un patrón que es de riesgo pero no claramente fraudulento. Whop captura automáticamente 48 horas después, a menos que actúes antes:
  • Captura para cobrar el dinero. El pago pasa a paid y Whop envía payment.succeeded, tu señal para completar el pedido.
  • Anula para liberar la retención. Whop revoca el acceso, devuelve el stock reservado y envía payment.canceled.
Whop envía payment.authorized cuando empieza la retención, y también para las autorizaciones solicitadas por API. Un pago retenido muestra status: "authorized" con substatus: "requires_capture". Obtén el estado del pago para consultar auto_capture_at. Esta regla retiene los pagos con tarjeta de al menos $250 cuya tarjeta se emitió fuera de EE. UU.
Una vez revisado el pedido, captúralo por ID de pago:
O anúlalo:

Limitaciones de la revisión

  • Solo se pueden retener tarjetas en sesión. Apple Pay, Google Pay, los pagos bancarios, con saldo y fuera de sesión, como las renovaciones, omiten la revisión. La coincidencia se sigue registrando en payment_rule_matches.
  • Los pagos creados con capture: false mantienen su propio calendario. Una regla de revisión nunca lo anula.
  • La captura es todo o nada. Reembolsa después para devolver una parte.
  • Los compradores tienen el producto antes de que decidas. Avísales si anulas el pago.

Deja pasar a los compradores de confianza

Una regla allow exime a los compradores de confianza de tus reglas de bloqueo, revisión y verificación.

Ajusta una regla

Lo que hace una regla queda fijado al crearla, así que los pagos que decidió siguen haciendo referencia a la regla que los decidió. Para cambiar su acción o sus condiciones, reemplázala: la regla antigua se elimina y una sucesora con un ID nuevo hereda su nombre, metadata y su estado activo. Aquí el umbral de bloqueo sube de 85 a 90 tras atrapar a demasiados compradores reales.
Desactiva una regla para pausarla y actívala para reanudarla. Elimínala para retirarla. Seguirá pudiéndose consultar con status: "deleted".

Mide el efecto

Cada pago indica en payment_rule_matches las reglas que coincidieron con él, con el nombre que tenía la regla en ese momento.
Si llegan disputas en pagos sin coincidencias, una regla es demasiado restrictiva. Una regla que coincide con muchos más pagos de los que estabas perdiendo es demasiado amplia. Para obtener totales a lo largo del tiempo, las métricas payment_rule_matches y payment_rule_matched_volume de la API de estadísticas se desglosan por payment_rule_ids o action.

Próximos pasos

Referencia de Payment Rules

Cada endpoint, parámetro y campo de respuesta.

Reembolsos y disputas

Responde a los contracargos que aun así se cuelan.