7. Liens de paiement

Pour encaisser sans développement. Même page publique que pour le particulier, avec Mobile Money ou carte selon les moyens autorisés ; la création est rattachée à une application.

Créer un lien de paiement

POST/payment-linksJeton de session

Corps de la requête

{
  "application_id": 12,
  "title": "Abonnement mensuel",
  "description": "Accès illimité pendant 30 jours",
  "amount": 5000,
  "currency": "XAF",
  "is_amount_fixed": true,
  "allowed_providers": [
    "orange_money_cm",
    "mtn_momo_cm"
  ],
  "redirect_url": "https://monsite.com/merci",
  "expires_at": "2026-12-31T23:59:59Z",
  "max_uses": 100,
  "slug": "abonnement-mensuel"
}

Réponse 201

{
  "success": true,
  "data": {
    "uuid": "b2c3d4e5-...",
    "slug": "abonnement-mensuel",
    "title": "Abonnement mensuel",
    "amount": "5000.00",
    "currency": "XAF",
    "is_amount_fixed": true,
    "status": "active",
    "use_count": 0,
    "public_url": "https://payment.kratospay.com/abonnement-mensuel",
    "images": []
  },
  "meta": {
    "request_id": "...",
    "timestamp": "..."
  }
}

Erreurs : 400 (montant manquant pour un lien fixe), 422 (application inconnue ou d'un autre compte, réseau inexistant dans allowed_providers).
Autres routes : GET /payment-links (liste), GET / PATCH / DELETE /payment-links/{uuid}, GET /payment-links/static (lien permanent + QR), galerie d'images en deux temps : POST /payment-links/{uuid}/images/upload-url puis POST /payment-links/{uuid}/images/confirm.
Un paiement par lien exige que l'entreprise soit validée KYC : sinon 422 à la création du paiement.