Aller au contenu
ReadyZone Docs
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-plan

Accè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"
}
AttributTypeObligatoireDescription
planIdstring (UUID)OuiForfait à acheter.
paymentPhonestringOuiNuméro Mobile Money utilisé pour le paiement.
notificationContactstringNonEmail ou téléphone de notification. À défaut, le numéro de paiement peut être utilisé.
usernamestringNonIdentifiant Wi-Fi souhaité. Généré automatiquement s’il est absent.
passwordstringNonMot de passe souhaité, minimum 6 caractères. Généré automatiquement s’il est absent.
promoCodestringNonCode 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
}
AttributTypeDescription
messagestringMessage de résultat de l’initialisation.
purchaseIdstring (UUID)Identifiant de l’achat local.
merchandTransactionIdstring ou nullRéférence marchande utilisée pour le suivi.
notchTransactionIdstring ou nullRéférence du fournisseur de paiement.
notchMessagestring ou nullInstruction retournée par le fournisseur.
paymentUrlstring ou nullLien de paiement, lorsque le mode le prévoit.
isGuestPurchasebooleanIndique 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)

Sur cette page