> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API de Payment Rules

> Una Payment Rule permite que una cuenta actúe sobre sus propios pagos antes de que lleguen al banco: bloquearlos, dejarlos pasar, enviarlos a revisión o pedir al comprador 3D Secure.

Cada regla coincide con un pequeño conjunto de atributos del pago, y todas las condiciones deben cumplirse para que se aplique.

La definición de una regla es fija una vez creada, de modo que los pagos que decidió siguen nombrando a la regla que los decidió. Usa [Reemplazar](https://docs.whop.com/es/api-reference/payment-rules/replace-a-payment-rule.md) para cambiar una, y [Listar campos](https://docs.whop.com/es/api-reference/payment-rules/list-fields.md) para conocer los atributos, operadores y valores que puede usar una condición.

Para ver un recorrido sobre cómo bloquear, revisar, desafiar y permitir checkouts para reducir el fraude, lee la guía [Gestionar el fraude](https://docs.whop.com/es/developer/guides/manage-fraud.md).

> [!WARNING]
>
> Una regla `review` puede dejar los embeds heredados en **Processing** hasta la captura. La captura automática está programada para 48 horas después de la autorización, pero completarla puede tardar más o fallar. Las reglas de revisión se aplican a toda la cuenta y siguen afectando a los embeds heredados. Consulta [la elegibilidad de la retención para revisión y las limitaciones del checkout](https://docs.whop.com/es/developer/guides/manage-fraud.md#review-a-payment-before-charging-it) antes de activarlas.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar reglas de pago](https://docs.whop.com/es/api-reference/payment-rules/list-payment-rules.md) | GET `/payment_rules` |
| [Recuperar una regla de pago](https://docs.whop.com/es/api-reference/payment-rules/retrieve-a-payment-rule.md) | GET `/payment_rules/{id}` |
| [Listar campos](https://docs.whop.com/es/api-reference/payment-rules/list-fields.md) | GET `/payment_rules/fields` |
| [Crear una regla de pago](https://docs.whop.com/es/api-reference/payment-rules/create-a-payment-rule.md) | POST `/payment_rules` |
| [Activar una regla de pago](https://docs.whop.com/es/api-reference/payment-rules/activate-a-payment-rule.md) | POST `/payment_rules/{id}/activate` |
| [Desactivar una regla de pago](https://docs.whop.com/es/api-reference/payment-rules/deactivate-a-payment-rule.md) | POST `/payment_rules/{id}/deactivate` |
| [Reemplazar una regla de pago](https://docs.whop.com/es/api-reference/payment-rules/replace-a-payment-rule.md) | POST `/payment_rules/{id}/replace` |
| [Actualizar una regla de pago](https://docs.whop.com/es/api-reference/payment-rules/update-a-payment-rule.md) | PATCH `/payment_rules/{id}` |
| [Eliminar una regla de pago](https://docs.whop.com/es/api-reference/payment-rules/delete-a-payment-rule.md) | DELETE `/payment_rules/{id}` |

## Atributos

**id** `string` *required*

ID de la regla de pago, con el prefijo `prule_`.

**account\_id** `string` *required*

ID de la cuenta, con el prefijo `biz_`.

**action** `string` *required*

Lo que solicita la regla de esta cuenta cuando se cumplen todas las condiciones. Gana una acción de regla de cuenta aplicable, en este orden: `allow`, `block`, `review`, `enforce_3ds`. Un `allow` anula las demás reglas de esta cuenta, nunca los controles de fraude propios de Whop. Un `review` solicita la autorización sin captura para un pago con tarjeta on-session elegible a través de Whop Payments. La captura automática está programada para 48 horas después de la autorización; captura o anula el pago antes para decidir antes. La captura puede completarse más tarde o fallar. La revisión se omite para métodos no compatibles, pagos off-session y pagos ya configurados para captura manual. Un `enforce_3ds` se omite cuando la regla de cuenta no puede aplicar un desafío. Otros requisitos de 3DS siguen aplicándose.

Opciones disponibles: `allow`, `block`, `review`, `enforce_3ds`

**conditions** `object` *required*

Las condiciones con las que se compara un pago. Hasta 10 condiciones y 8 KiB una vez serializadas.

> [accordion] Propiedades
>
> **all** `object[]` *required*
>
> Condiciones que deben cumplirse todas para que se aplique la regla. Un atributo del pago que la regla no puede leer no coincide.
>
> > [accordion] Propiedades
> >
> > **field** `string` *required*
> >
> > El atributo del pago que lee esta condición.
> >
> > Opciones disponibles: `risk_score`, `amount_in_usd`, `card_country`, `card_brand`, `card_funding`, `card_bin`, `billing_country`, `billing_postal_code`, `billing_city`, `customer_email`, `email_domain`, `ip_address`, `ip_country`
> >
> > **operator** `string` *required*
> >
> > Cómo se compara el atributo del pago con el valor.
> >
> > Opciones disponibles: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `in`, `not_in`, `starts_with`, `contains`, `ends_with`, `in_cidr`
> >
> > **value** `number or string or string[]` *required*
> >
> > El valor con el que comparar.

**created\_at** `string` *required*

Cuándo se creó la regla, como marca de tiempo ISO 8601.

**deleted\_at** `string | null` *required*

Cuándo se eliminó la regla, como marca de tiempo ISO 8601. `null` salvo que `status` sea `deleted`.

**metadata** `object` *required*

Valores personalizados de cadena a cadena para tu integración. Máximo 50 claves, 40 caracteres por clave y 500 caracteres por valor.

**name** `string` *required*

Un nombre para esta regla. Hasta 255 caracteres.

**status** `string` *required*

Si la regla se aplica a los pagos. Una regla `deleted` se conserva para que los pagos que ya decidió sigan nombrándola.

Opciones disponibles: `active`, `inactive`, `deleted`

**updated\_at** `string` *required*

Cuándo cambió la regla por última vez, como marca de tiempo ISO 8601.

```json PaymentRule theme={null}
{
	"id": "prule_xxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"name": "Block high-risk cards from outside the US",
	"status": "active",
	"action": "block",
	"conditions": {
		"all": [
			{
				"field": "risk_score",
				"operator": "gte",
				"value": 85
			},
			{
				"field": "card_country",
				"operator": "neq",
				"value": "US"
			}
		]
	},
	"metadata": {},
	"created_at": "2026-09-01T12:00:00.000Z",
	"updated_at": "2026-09-01T12:00:00.000Z",
	"deleted_at": null
}
```


## Related topics

- [API de Payments](https://docs.whop.com/es/api-reference/payments/payment.md)
- [API de Cashback Rules](https://docs.whop.com/es/api-reference/cashback-rules/cashback-rule.md)
- [API de Payment Quotes](https://docs.whop.com/es/api-reference/payment-quotes/payment-quote.md)
