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

# Paiements

Un paiement iPayMoney est créé avec une référence externe fournie par votre système et reçoit des références iPayMoney. Votre application doit conserver ces valeurs pour suivre l'opération et traiter les notifications.

## Cycle de vie

| Statut      | Signification                                                     | Action recommandée                                                                         |
| ----------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `initiated` | La demande a été créée.                                           | Attendre une mise à jour ou vérifier le statut.                                            |
| `pending`   | Le fournisseur attend une confirmation ou poursuit le traitement. | Ne pas valider la commande ; attendre le webhook ou interroger l'API.                      |
| `succeeded` | Le paiement est confirmé.                                         | Valider la commande de façon idempotente.                                                  |
| `failed`    | Le paiement a échoué.                                             | Afficher un échec et permettre une nouvelle tentative avec une nouvelle référence externe. |
| `refunded`  | Le paiement a été remboursé.                                      | Mettre à jour la commande et les écritures associées.                                      |

## Créer un paiement

Le contrat principal utilise `POST /api/v1/payments`. Les champs communs sont `amount`, `country`, `currency`, `msisdn`, `transaction_id` et `customer_name`.

[Voir le Démarrage rapide](/ipaymoney/demarrage-rapide) ou [ouvrir la Référence API](/api-reference).

## Références

* `transaction_id` : référence unique créée par votre système et renvoyée comme `external_reference` lors de la consultation.
* `reference` : référence interne iPayMoney utilisée par l'endpoint de vérification.
* `public_reference` : référence publique utile pour les échanges avec le client ou le support.

## Moyens de paiement

La disponibilité dépend du pays, de l'environnement et des moyens activés sur le compte. Le type générique `mobile` sélectionne l'opérateur à partir du `msisdn`.

[Consulter les moyens de paiement](/ipaymoney/paiements/methode-de-paiements)

## Règle de validation

Une redirection navigateur ou la réponse de création ne suffit pas pour confirmer une commande. La décision finale doit être prise côté serveur à partir d'un `status: succeeded` obtenu par [vérification API](/ipaymoney/paiements/verification) ou par webhook authentifié.