Koory Core

Documentation publique

Docs développeur Koory Core

Cette page reste publique et couvre uniquement l’intégration développeur: authentification, endpoints, variables d’environnement, sandbox et mise en production.

  • Base URL production : https://koory-core-backend.onrender.com/api
  • Authentification standard : JWT utilisateur pour les apps web/mobile.
  • Intégrations serveur : credentials applicatifs fournis ou régénérés par l’admin.

Démarrage rapide

  1. Créer un compte développeur ou se connecter au portail.
  2. Déclarer l’URL du backend Koory Core dans votre frontend et votre backend.
  3. Tester le flux login/register puis les endpoints wallet, webhooks et notifications.
  4. Passer en production avec les credentials validés pour votre application.

Accès

Le portail public permet de créer un compte développeur ou de se connecter pour récupérer ses informations d’intégration.

Créer un compteSe connecter

Périmètre privé

La documentation ecosystem, les playbooks Koory’s et les procédures admin ne sont plus exposés ici. Ils sont consultables uniquement dans le dashboard admin.

Onboarding développeur

Créez un compte, récupérez vos credentials depuis votre espace développeur et branchez votre application sur le backend Koory Core.

  • Inscription ou connexion via le portail public.
  • Configuration de CORE_API_URL et NEXT_PUBLIC_CORE_API_URL.
  • Tests d’authentification, webhooks et paiements en sandbox.

Authentification et sécurité

Les applications web et mobile utilisent le JWT utilisateur. Les intégrations serveur-à-serveur utilisent des credentials applicatifs dédiés.

  • Header Authorization: Bearer <token> pour les flux utilisateurs.
  • Headers x-api-key et x-api-secret pour les intégrations back-office ou partenaires.
  • Rotation des clés depuis le dashboard quand nécessaire.

Services exposés

Koory Core centralise l’authentification, le wallet, les paiements, les notifications, les webhooks et les services delivery.

  • Auth et rôles applicatifs.
  • Wallet payin et payout selon les providers activés.
  • Notifications, webhooks et suivi opérationnel.

Configuration minimale

Base URL et appel type

const baseURL = 'https://koory-core-backend.onrender.com/api'

fetch(baseURL + '/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ email, password, tenantId })
})

Variables d’environnement

À déclarer côté app

  • CORE_API_URL : URL backend utilisée par votre backend applicatif.
  • NEXT_PUBLIC_CORE_API_URL : URL backend injectée dans votre frontend Next.js.
  • KOORY_API_KEY / KOORY_API_SECRET : uniquement pour les intégrations serveur-à-serveur.
  • JWT : à récupérer via les routes auth pour tous les flux utilisateurs protégés.