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 ou ouvrir la Référence API.

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

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 ou par webhook authentifié.