Parcours d'onboarding Network

Cette page est la checklist opérateur pour lomi. Network. Chaque étape utilise des endpoints déjà supportés avec l'en-tête Lomi-Account, pas de routes Network supplémentaires.

Network est sur invitation. Votre organisation doit être approuvée comme Opérateur avant que ces étapes s'appliquent.

Étape 1: Compte opérateur et clé API

Terminez l'onboarding marchand sur le tableau de bord.
Créez une clé API secrète pour l'organisation Opérateur (test d'abord).
Stockez la clé uniquement côté serveur.

Voir Clés API.

Étape 2: Connecter un compte membre

Ouvrez Network dans le tableau de bord (/{organizationId}/network).
Créez une invitation sous Enrollments et copiez le lien (/network/enroll/{token}).
Après l'inscription du membre, activez l'adhésion (pending_review → active).
Notez l'id public du membre (acct_...) pour l'en-tête Lomi-Account.

Si l'adhésion est absente ou inactive, l'API renvoie network_membership_not_found ou network_membership_not_active, voir Network: erreurs d'autorisation courantes.

Étape 3: Accorder des capacités

Les capacités sont par adhésion et environnement. À l'activation, lomi. accorde automatiquement les capacités de l'invitation (requested_capabilities) ou les défauts opérateur.

Minimum pour les paiements :

Capacité	Utilisée pour
`payment.create`	`POST /checkout-sessions`, `POST /charge/*`
`transaction.read_own` ou `transaction.read`	`GET /transactions`
`refund.create`	`POST /refunds`
`customer.read` / `customer.write`	APIs clients au nom du membre

Ajustez les capacités dans l'onglet Members du tableau de bord si nécessaire après activation. Capacité manquante → network_capability_missing.

Étape 4: Premier paiement délégué (test)

Créez une session checkout pour le membre :

curl -sS -X POST "https://sandbox.api.lomi.africa/checkout-sessions" \
  -H "X-API-KEY: $LOMI_OPERATOR_TEST_KEY" \
  -H "Lomi-Account: acct_MEMBER_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "currency_code": "XOF",
    "title": "Test Network",
    "success_url": "https://example.com/success",
    "cancel_url": "https://example.com/cancel"
  }'

Ouvrez l'URL checkout retournée, payez avec un moyen sandbox, et confirmez via webhook ou GET /transactions/{id}.

Étape 5: Rapprocher et passer en live

Enregistrez les webhooks sur l'organisation Opérateur (les événements reflètent l'activité déléguée selon votre configuration tableau de bord).
Utilisez GET /transactions avec Lomi-Account pour le support et la réconciliation.
Passez aux clés live et capacités live quand le membre est prêt pour la production.

Voir Passer en production et Vérifier les paiements.