API checkout ministry

Référence d'intégration pour les backends SI métier (ex. portail MinJust) : création de sessions de paiement, réception des webhooks signés, filets de reprise.

Objectif

Le SI métier crée une session via POST /checkout/sessions. Le citoyen paie sur le checkout Epayment (mobile money, carte ou agence). Le SI reçoit une notification fiable à la confirmation (checkout.completed ou verify-completion en embed).

Responsabilité SI	Délégué à Epayment
POST /checkout/sessions	Collecte numéro / carte / choix d'offre
Redirect checkout_url ou montage SDK embed	Orchestration de la collecte (push MM, redirect carte)
Vérification webhooks HMAC et/ou verify-completion	Appels directs PSP
Déblocage dossier sur confirmation serveur idempotente	Calcul du montant dû

Le SI n'appelle pas les routes checkout citoyen (offers, collecte / attempts) avec sk_. Voir Mobile money - Audience.

Parcours recommandé

1. Mise en service - clés, webhooks, recette
2. Clés API - scopes application, tenant, plateforme
3. Catalogue services - service_code, mapping ERP
4. Référence API - endpoints et champs
5. Checkout hébergé - redirect (défaut)
6. Checkout embarqué - SDK iframe
7. Idempotence - clés et retries
8. Paiement agence - payment_ref
9. Mobile money - webhooks MM, sandbox, pas de direct push
10. Paiement par carte - multi-devise, comportement refus/timeout
11. Webhooks - événements et payloads
12. Sécurité webhooks - HMAC et rotation
13. Polling et filets - GET, verify-completion

Un partenaire déjà branché sur apiKey, init-checkout ou partners/payments suit Cash-in déprécié, pas ce parcours.

Base API

https://paymentdev-api.akieni.tech/api/v1
Authorization: Bearer sk_test_...
Content-Type: application/json

Modes checkout

Mode	Réponse clé	UX citoyen
hosted (défaut)	checkout_url	Redirect HTTP
embedded	client_secret, embed_checkout_url	Overlay SDK + iframe

Clés API (aperçu)

Scope	tenant_id requis	Usage
application	Non	Intégration par application métier
tenant	Non	Clé régie, application intégrateur par défaut
platform	Oui	eGouv, e-Citizen - voir eGouv

Détail : Clés API.