API v1 · PRODUCTION

Guide d'intégration

Orchestration des paiements de l'administration congolaise. Vous encaissez via Epayment ; les fonds ne transitent jamais par la plateforme.

Démarrer en 5 minutes Référence API

6endpoints checkout ministry

< 5 minpremière session

24 hTTL session par défaut

POST /checkout/sessions

-cmd">curl -sS -X POST "https://paymentdev-api.akieni.tech/api/v1/checkout/sessions" \
  -H "Authorization: Bearer $EPAY_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: CJ-2026-88421" \
  -d '{
    "order_id": "CJ-2026-88421",
    "amount": 8000,
    "currency": "XAF",
    "description": "Casier judiciaire simple",
    "success_url": "https://justice.gouv.cg/retour"
  }'

CHOISISSEZ VOTRE PARCOURS

Trois façons d'intégrer

Comparer les parcours

HOSTED / EMBED

SI ministérielSession checkout, webhooks signés. Votre backend ne collecte jamais de champ de paiement.

SERVER TO SERVER

ERP régieEndpoints REST pour créances, lots de paiement et confirmations d'encaissement.

SDK EMBED

eGouv / e-CitizenClé plateforme, tenant cible et SDK embarqué sur le portail transverse.

RÉFÉRENCE

Les endpoints essentiels

Ministry checkout et ERP couvrent le cycle : session de paiement, webhooks, créances citoyen et disbursement.

Voir la référence API

POST/checkout/sessionsOuvrir une session de paiement GET/checkout/sessions/{id}Statut et détail d'une session GET/checkout/sessionsListe paginée des sessions POST/checkout/sessions/{id}/cancelAnnuler une session ouverte POST/checkout/sessions/verify-completionVérifier un jeton embed (SDK)POST/erp/duesPull créances ERP (portail citoyen)

SÉCURITÉVérifier une signatureValider l'en-tête HMAC et rejouer sans risque.OPÉRATIONSEncaissement en agenceDu code de référence au reçu imprimé au guichet.COMPTABILITÉJournal et recetteRapprocher encaissements et écritures ERP.RECETTEEnvironnement de testURLs, clés de test et cartes de référence.