Référence API
Achat invité
Démarrer un achat invité (sans compte) et créer une transaction de paiement.
POST /api/payments/guest-buy-planAccès : Public (contrôles anti-abus côté API)
Cas d'usage opérateur
Bouton “Paiement instantané”: un client de passage paie rapidement sans créer de compte.
Paramètres
- key (query, optionnel selon configuration)
Corps de requête
{
"planId": "e6fd2c2b-1234-4a7e-8a6a-12ab34cd56ef",
"paymentPhone": "+237612345678",
"notificationContact": "client@example.com",
"username": "AA:BB:CC:DD:EE:FF",
"password": "Strong@Pass123",
"promoCode": "READY10"
}| Attribut | Type | Obligatoire | Description |
|---|---|---|---|
planId | string (UUID) | Oui | Forfait à acheter. |
paymentPhone | string | Oui | Numéro Mobile Money utilisé pour le paiement. |
notificationContact | string | Non | Email ou téléphone de notification. À défaut, le numéro de paiement peut être utilisé. |
username | string | Non | Identifiant Wi-Fi souhaité. Généré automatiquement s’il est absent. |
password | string | Non | Mot de passe souhaité, minimum 6 caractères. Généré automatiquement s’il est absent. |
promoCode | string | Non | Code promotionnel à appliquer. |
Corps de réponse
{
"message": "Achat invité initié avec succès",
"purchaseId": "purchase_uuid",
"merchandTransactionId": "GR-TX-XXXXXXXXXX",
"notchTransactionId": "np_xxxxx",
"notchMessage": "Confirmez le paiement sur votre téléphone",
"paymentUrl": "https://...",
"isGuestPurchase": true
}| Attribut | Type | Description |
|---|---|---|
message | string | Message de résultat de l’initialisation. |
purchaseId | string (UUID) | Identifiant de l’achat local. |
merchandTransactionId | string ou null | Référence marchande utilisée pour le suivi. |
notchTransactionId | string ou null | Référence du fournisseur de paiement. |
notchMessage | string ou null | Instruction retournée par le fournisseur. |
paymentUrl | string ou null | Lien de paiement, lorsque le mode le prévoit. |
isGuestPurchase | boolean | Indique un achat sans compte. |
En cas d’échec métier, la réponse peut contenir status: "failed" et un message d’erreur au lieu d’une transaction exploitable.
Codes de statut
- 201 Created
- 400 Bad Request (données invalides)
- 404 Not Found (forfait introuvable)
- 422 Unprocessable Entity (données ou paiement non traitables)
- 429 Too Many Requests (limite anti-abus)