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

# Paiement direct

> Envoyez une demande de paiement directement sur le téléphone du client.

Dans le mode direct, flasshpay envoie une demande de paiement sur le téléphone du client. Il valide avec son code PIN mobile money. Vous n'avez pas de page à afficher.

> [!NOTE]
>
> Le mode direct est le mode par défaut : sans `"checkout": "hosted"`, la collecte est directe.

## Créer la collecte (production)

Trois champs sont obligatoires : `payment_method`, `name` et `mobile`.

```bash theme={null}
curl -X POST "https://flasshpay.my/api/v1/collections" \
  -H "X-FlashPay-Key: fp_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "country_code": "CM",
    "amount": 5000,
    "transaction_id": "commande-1043",
    "payment_method": "MTN",
    "name": "Aïcha Koné",
    "mobile": "670000000",
    "description": "Commande 1043"
  }'
```

Le code `payment_method` vient de la page [Moyens de paiement](https://docs.flasshpay.my/integration/moyens-de-paiement.md).

## Réponse

```json theme={null}
{
  "mode": "live",
  "data": {
    "transaction_id": "commande-1043",
    "country_code": "CM",
    "currency_code": "XAF",
    "amount": 5000,
    "payment_method": "MTN",
    "status": "pending",
    "platform_fee": 150,
    "net_payable": 4850,
    "message": "Demande envoyée. Le client valide le paiement avec son code PIN sur son téléphone."
  }
}
```

Le statut est `pending` tant que le client n'a pas validé.

## Frais

Par défaut, le client règle les frais en plus du montant. Pour les prélever sur votre montant, ajoutez `"pass_digital_charge": false`.

## Mode test

Avec une clé `fp_test_`, aucun appel n'est fait à l'opérateur. La réponse porte `"mode": "test"`.

> [!WARNING]
>
> Ne marquez jamais une commande payée sur la seule réponse de création. Attendez le statut `successful` ou le webhook.

## Minimum

La RDC impose un minimum de 800 CDF. En dessous, l'API renvoie une erreur `400`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.