4. Create an application

One application = one separate integration (website, mobile app, terminal). Each has its own keys, webhook, balance and payment links. Its id goes in X-Application-ID.

Create an application

POST/applicationsSession token

Request body

{
  "name": "Boutique en ligne",
  "webhook_url": "https://mon-site.cm/webhooks/kratospay",
  "country_id": 1
}

Response 201

{
  "success": true,
  "data": {
    "application": {
      "id": 12,
      "name": "Boutique en ligne",
      "webhook_url": "https://mon-site.cm/webhooks/kratospay",
      "has_webhook": true,
      "is_active": true,
      "created_at": "2026-11-02T08:00:00Z"
    },
    "webhook_secret": "whsec_<secret>"
  },
  "meta": {
    "request_id": "...",
    "timestamp": "..."
  }
}

Code	When
401	Expired token.
422	Missing name or invalid webhook URL.

webhook_secret is shown only once, even without webhook_url. Regenerate it: POST /applications/{id}/webhook/rotate-secret.
Manage: GET /applications, GET /applications/{id}, PATCH /applications/{id} (name, webhook_url, is_active), DELETE /applications/{id}. Countries with transactions: GET /applications/{id}/countries.