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.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 registrathree_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 reglareview 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
paidy Whop envíapayment.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.
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.
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: falsemantienen 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 reglaallow 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.
status: "deleted".
Mide el efecto
Cada pago indica enpayment_rule_matches las reglas que coincidieron con él, con el nombre que tenía la regla en ese momento.
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.

