Introduction¶

L'API M-Pay permet d'automatiser la gestion des paiements hôteliers. Elle est conçue pour être intégrée dans votre PMS (Property Management System) afin de :

Créer des demandes de paiement (empreintes bancaires ou pré-paiements)
Envoyer des liens de paiement sécurisés aux clients par email
Suivre l'état des paiements en temps réel
Capturer ou rembourser des paiements

Concepts clés¶

Demande de paiement (PaymentRequest)¶

C'est l'objet central de l'API. Chaque demande correspond à une réservation et contient :

Le type : empreinte (IMPRINT) ou pré-paiement (DEPOSIT)
Le montant et la devise
Les coordonnées du client (email, nom)
La référence de réservation de votre PMS

Types de demande¶

Type	Code	Description
Empreinte bancaire	`IMPRINT`	Enregistre la carte du client sans débit. Permet de capturer le montant en cas de no-show.
Pré-paiement	`DEPOSIT`	Débite immédiatement le montant indiqué (arrhes, acompte).

Cycle de vie¶

Création (API)
    │
    ▼
NOT_INITIATED ──► PENDING ──► AUTHORISED ──► CAPTURED
                                   │
                                   ├──► REFUSED
                                   ├──► EXPIRED
                                   └──► CANCELLED

CAPTURED ──► REFUNDED

Environnements¶

Environnement	URL	Usage
Test	`https://staging.votre-domaine.com/api/`	Intégration et tests
Production	`https://votre-domaine.com/api/`	Paiements réels

Mode TEST PayZen

En mode TEST, utilisez les cartes de test PayZen pour simuler les paiements.