> ## 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 Payment Rules

> Une Payment Rule permet à un compte d'agir sur ses propres paiements avant qu'ils n'atteignent la banque : les bloquer, les laisser passer, les envoyer en vérification ou demander à l'acheteur une authentification 3D Secure.

Chaque règle s'applique à un petit ensemble d'attributs de paiement, et chaque condition doit être remplie pour qu'elle s'applique.

La définition d'une règle est figée une fois créée, de sorte que les paiements qu'elle a tranchés continuent de mentionner la règle qui les a tranchés. Utilisez [Remplacer](https://docs.whop.com/fr/api-reference/payment-rules/replace-a-payment-rule.md) pour en modifier une, et [Lister les champs](https://docs.whop.com/fr/api-reference/payment-rules/list-fields.md) pour connaître les attributs, opérateurs et valeurs qu'une condition peut utiliser.

Pour une présentation détaillée du blocage, de la vérification, de la demande d'authentification et de l'autorisation des checkouts afin de réduire la fraude, consultez le guide [Gérer la fraude](https://docs.whop.com/fr/developer/guides/manage-fraud.md).

> [!WARNING]
>
> Une règle `review` peut laisser les anciennes intégrations embarquées sur **Processing**
> jusqu'à la capture. La capture automatique est programmée 48 heures après
> l'autorisation, mais elle peut prendre plus de temps ou échouer. Les règles de vérification s'appliquent
> à l'ensemble du compte et s'appliquent toujours aux anciennes intégrations embarquées. Consultez [l'éligibilité à la mise en attente pour vérification
> et les limitations du
> checkout](https://docs.whop.com/fr/developer/guides/manage-fraud.md#review-a-payment-before-charging-it)
> avant de les activer.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les règles de paiement](https://docs.whop.com/fr/api-reference/payment-rules/list-payment-rules.md) | GET `/payment_rules` |
| [Récupérer une règle de paiement](https://docs.whop.com/fr/api-reference/payment-rules/retrieve-a-payment-rule.md) | GET `/payment_rules/{id}` |
| [Lister les champs](https://docs.whop.com/fr/api-reference/payment-rules/list-fields.md) | GET `/payment_rules/fields` |
| [Créer une règle de paiement](https://docs.whop.com/fr/api-reference/payment-rules/create-a-payment-rule.md) | POST `/payment_rules` |
| [Activer une règle de paiement](https://docs.whop.com/fr/api-reference/payment-rules/activate-a-payment-rule.md) | POST `/payment_rules/{id}/activate` |
| [Désactiver une règle de paiement](https://docs.whop.com/fr/api-reference/payment-rules/deactivate-a-payment-rule.md) | POST `/payment_rules/{id}/deactivate` |
| [Remplacer une règle de paiement](https://docs.whop.com/fr/api-reference/payment-rules/replace-a-payment-rule.md) | POST `/payment_rules/{id}/replace` |
| [Mettre à jour une règle de paiement](https://docs.whop.com/fr/api-reference/payment-rules/update-a-payment-rule.md) | PATCH `/payment_rules/{id}` |
| [Supprimer une règle de paiement](https://docs.whop.com/fr/api-reference/payment-rules/delete-a-payment-rule.md) | DELETE `/payment_rules/{id}` |

## Attributs

**id** `string` *required*

ID de la règle de paiement, préfixé par `prule_`.

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

ID du compte, préfixé par `biz_`.

**action** `string` *required*

Ce que demande la règle de ce compte lorsque toutes les conditions correspondent. Une seule action applicable parmi les règles du compte l'emporte, dans cet ordre : `allow`, `block`, `review`, `enforce_3ds`. Une action `allow` prévaut sur les autres règles de ce compte, mais jamais sur les propres contrôles anti-fraude de Whop. Une action `review` demande une autorisation sans capture pour un paiement par carte éligible effectué en session via Whop Payments. La capture automatique est programmée 48 heures après l'autorisation ; capturez ou annulez le paiement avant ce délai pour décider plus tôt. La capture peut aboutir plus tard ou échouer. La vérification est ignorée pour les moyens de paiement non pris en charge, les paiements hors session et les paiements déjà configurés pour une capture manuelle. Une action `enforce_3ds` est ignorée lorsque la règle du compte ne peut pas appliquer de demande d'authentification. Les autres exigences 3DS s'appliquent toujours.

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

**conditions** `object` *required*

Les conditions auxquelles un paiement est comparé. Jusqu'à 10 conditions, et 8 Kio une fois sérialisées.

> [accordion] Propriétés
>
> **all** `object[]` *required*
>
> Conditions qui doivent toutes correspondre pour que la règle s'applique. Un attribut de paiement que la règle ne peut pas lire ne correspond pas.
>
> > [accordion] Propriétés
> >
> > **field** `string` *required*
> >
> > L'attribut de paiement que lit cette condition.
> >
> > Options 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*
> >
> > La manière dont l'attribut de paiement est comparé à la valeur.
> >
> > Options disponibles : `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `in`, `not_in`, `starts_with`, `contains`, `ends_with`, `in_cidr`
> >
> > **value** `number or string or string[]` *required*
> >
> > La valeur de comparaison.

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

Date de création de la règle, sous forme d'horodatage ISO 8601.

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

Date de suppression de la règle, sous forme d'horodatage ISO 8601. `null` sauf si `status` vaut
`deleted`.

**metadata** `object` *required*

Valeurs personnalisées de type chaîne vers chaîne pour votre intégration. 50 clés maximum, 40
caractères par clé, 500 caractères par valeur.

**name** `string` *required*

Un nom pour cette règle. Jusqu'à 255 caractères.

**status** `string` *required*

Indique si la règle est appliquée aux paiements. Une règle `deleted` est conservée afin que les paiements qu'elle a déjà tranchés la mentionnent toujours.

Options disponibles : `active`, `inactive`, `deleted`

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

Date de dernière modification de la règle, sous forme d'horodatage 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

- [Delete a Payment Rule](https://docs.whop.com/fr/api-reference/payment-rules/delete-a-payment-rule.md)
- [Update a Payment Rule](https://docs.whop.com/fr/api-reference/payment-rules/update-a-payment-rule.md)
- [Activate a Payment Rule](https://docs.whop.com/fr/api-reference/payment-rules/activate-a-payment-rule.md)
