# lomi. Radar
Source: https://docs.lomi.africa/build/money/radar

Analysez les encaissements carte et mobile money avec évaluations de risque, webhooks et de petits frais sur les facteurs déclenchés.

***

title: lomi. Radar
description: Analysez les encaissements carte et mobile money avec évaluations de risque, webhooks et de petits frais sur les facteurs déclenchés.
--------------------------------------------------------------------------------------------------------------------------------------------------

import { Callout } from '@/components/docs/docs-callout';

**lomi. Radar** évalue les **encaissements entrants** (carte, MTN, Wave) avant leur finalisation. Chaque paiement est enregistré comme évaluation de risque. Quand Radar est actif pour l'organisation, la transaction affiche **Normal**, **Risqué** ou **Bloqué**. C'est distinct des [Litiges](/build/money/disputes) (chargebacks carte a posteriori) et des contrôles de retrait plateforme décrits dans [Payouts](/build/money/payouts).

<Callout type="info">
  Chaque paiement est évalué en arrière-plan. L'application des règles, l'étiquette de risque, les webhooks et les frais de facteur commencent quand l'organisation active Radar. Les règles plateforme (dont les comptes non vérifiés qui encaissent des cartes USD ou EUR) ne peuvent pas être désactivées tant que Radar est actif.
</Callout>

## Mode

```bash
curl -X PATCH "https://api.lomi.africa/organizations/radar-settings" \
  -H "X-API-KEY: $LOMI_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true, "mode": "block" }'
```

| Champ                      | Valeurs                           | Effet                                                        |
| -------------------------- | --------------------------------- | ------------------------------------------------------------ |
| `enabled`                  | `true` / `false` (défaut `false`) | Active l'application, les étiquettes et les frais de facteur |
| `mode`                     | `monitor`                         | Signale sans bloquer                                         |
| `mode`                     | `block`                           | Refuse les encaissements selon les règles block              |
| `stripe_radar_passthrough` | `true` (défaut)                   | Enrichit avec les signaux réseau carte après capture         |

Paramètres → Radar affiche le même interrupteur et le même mode, plus les règles en vigueur. Les paiements risqués ou bloqués créent aussi une notification dans le tableau de bord quand Radar est actif.

## Bloquer un client

Ajoute son téléphone, son e-mail et ses cartes enregistrées à la liste de blocage de l’organisation. Les encaissements correspondants sont refusés tant que Radar est actif. Débloquer retire ces identifiants.

Tableau de bord : fiche client, ou **C’était de la fraude** sur une transaction signalée (cela bloque aussi le client).

```bash
curl -X POST "https://api.lomi.africa/customers/$CUSTOMER_ID/block" \
  -H "X-API-KEY: $LOMI_SECRET_KEY"

curl -X POST "https://api.lomi.africa/customers/$CUSTOMER_ID/unblock" \
  -H "X-API-KEY: $LOMI_SECRET_KEY"
```

MCP : `lomi_customers` avec `action=block` ou `action=unblock`.

## Règles intégrées

| Règle                              | Rails            | Action par défaut                                       |
| ---------------------------------- | ---------------- | ------------------------------------------------------- |
| `high_value_charge`                | carte, MTN, Wave | Flag ≥ 500 000 XOF (équivalent)                         |
| `velocity_charges_1h`              | tous             | Block > 20 encaissements / client / heure               |
| `repeat_phone_24h`                 | MTN, Wave        | Flag même téléphone sur plusieurs clients               |
| `card_country_mismatch`            | carte            | Flag pays hors UEMOA                                    |
| `unverified_card_foreign_currency` | carte            | Flag cartes USD/EUR sur compte non vérifié (plateforme) |

## Lister les évaluations

```bash
curl "https://api.lomi.africa/risk-assessments?decision=flag" \
  -H "X-API-KEY: $LOMI_SECRET_KEY"
```

Filtres : `decision`, `rail`, `startDate`, `endDate`. Les évaluations ne sont renvoyées que si Radar est actif pour l'organisation.

## Webhooks

* `PAYMENT_RISK_FLAGGED`
* `PAYMENT_RISK_BLOCKED`

Ces événements ne partent que si Radar est actif.

## Litiges vs Radar vs retraits

|           | **Litiges**                    | **Radar**                                    | **Contrôles retrait**    |
| --------- | ------------------------------ | -------------------------------------------- | ------------------------ |
| Moment    | Après chargeback               | Avant/pendant encaissement                   | Au retrait               |
| API       | `GET /disputes`                | `GET /risk-assessments`                      | Aucune (interne)         |
| Dashboard | Paramètres → Support → Litiges | Fiche transaction : Normal / Risqué / Bloqué | Message d'erreur retrait |

## Frais

Radar n'ajoute pas de frais quand une règle se déclenche. Les règles plateforme sont gratuites et toujours actives. La surveillance est gratuite. Le blocage et la revue ne sont pas tarifés tant que la précision des règles n'est pas mesurée. Un prix ultérieur, s'il existe, est un montant fixe par paiement analysé ou une inclusion dans un plan. Il n'est jamais lié à un facteur déclenché.