7. Payment links

To collect without development. Same public page as for individuals, with Mobile Money or card according to the allowed methods; creation is tied to an application.

Create a payment link

POST/payment-linksSession token

Request body

{
  "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"
}

Response 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": "..."
  }
}

Errors: 400 (missing amount for a fixed link), 422 (unknown application or owned by another account, network not found in allowed_providers).
Other routes: GET /payment-links (list), GET / PATCH / DELETE /payment-links/{uuid}, GET /payment-links/static (permanent link + QR), image gallery in two steps: POST /payment-links/{uuid}/images/upload-url then POST /payment-links/{uuid}/images/confirm.
A payment through a link requires the business to be KYC verified: otherwise 422 when the payment is created.