# Encaissements directs avancés
Source: https://docs.lomi.africa/api/charge

Créez des paiements Wave, MTN et carte embarquée lorsque le checkout hébergé n’est pas le bon choix.

***

title: 'Encaissements directs avancés'
description: 'Créez des paiements Wave, MTN et carte embarquée lorsque le checkout hébergé n’est pas le bon choix.'
index: true
-----------

Les APIs d’encaissement direct sont destinées aux équipes qui ont besoin d’un contrôle plus bas niveau que le checkout hébergé ou les liens de paiement. Pour le flux recommandé par défaut, utilisez les [Checkout sessions](/api/checkout-sessions).

## Quand les utiliser ?

Utilisez les encaissements directs quand :

* Votre application possède déjà l’interface de paiement.
* Vous devez démarrer un paiement Wave ou MTN depuis un flux personnalisé.
* Vous devez collecter une carte embarquée avec confirmation côté client.
* Vous savez gérer les états en attente, échec, annulation et complétion.

## Ce qu’il faut prévoir

Une intégration directe doit inclure :

* Une création côté serveur avec clé secrète.
* Des états visibles pour attente et échec.
* Des webhooks pour la réconciliation finale.
* Une gestion sûre des `client_secret` renvoyés pour les flux carte embarqués.

## Requête

### Paramètres d’URL

*Pas d’autre paramètre dans l’URL.*

### Paramètres de requête

*Aucun paramètre de requête.*

### En-têtes

| Nom            | Emplacement | Obligatoire | Schéma | Description                                                                                          |
| -------------- | ----------- | ----------- | ------ | ---------------------------------------------------------------------------------------------------- |
| `Lomi-Version` | header      | Non         | -      | Optional schema version pin. Echoes OpenAPI info.version (currently 1.2.0). Routes stay unversioned. |

## Réponses

| Statut | Description |
| ------ | ----------- |
| `200`  | -           |

## Erreurs

Les erreurs suivent un format JSON standard. **401** : clé manquante ou invalide. **404** : ressource introuvable. **429** : trop de requêtes. Pour les créations, envoyez une clé d’idempotence si votre flux le permet.