Service Providers

Cette section ne concerne pas tous les intégrateurs

Elle s'adresse aux plateformes qui créent des comptes Jèko pour d'autres entreprises. Si vous encaissez pour votre propre compte, allez directement à Paiements ou Transferts.

Vous intégrez avec un agent de codage ?

Le serveur MCP lui donne cette documentation en direct, et relit ses requêtes avant qu'elles ne partent en production.

Connecter votre agent

Le programme Service Provider s'adresse aux marketplaces et aux agrégateurs qui proposent le portefeuille Jèko à leurs marchands. Vous intégrez ces marchands par appel API, avec la clé de votre entreprise Service Provider. Une fois le lien établi, l'encaissement et le reversement passent par une clé plateforme émise pour le marchand, sur un magasin qui vous est dédié.

Le détail du modèle est dans l'introduction.

Deux clés

Clé	À quoi elle sert	Endpoints
Clé entreprise du Service Provider	Intégrer, rattacher, vérifier, créer des clés et des webhooks, assigner un catalogue de frais
Clé plateforme	Encaisser, transférer, et gérer un escrow, au nom du marchand	Partner API habituelle (`payment_requests`, `transfers`, `escrows`, …)

La clé entreprise ne déplace pas d'argent. La clé plateforme est limitée au magasin dédié de ce marchand. Les frais et le droit au remboursement dépendent de la clé qui initie l'opération : voir Tarifs et catalogues.

Ce que vous pouvez faire

Intégrer un nouveau marchand

Villes, activités, puis création du compte au niveau 0.

Rattacher un marchand déjà inscrit

Demande de consentement, suivi, liste et détachement.

Vérifier l'identité

KYC puis KYB, sur une page hébergée par Jèko.

Créer la clé et le magasin

Clé plateforme, secrète une seule fois, scopée à votre magasin.

Fixer vos frais

Un catalogue par marchand, assigné par l'API.

Recevoir les webhooks

Abonnement du marchand, filtré sur votre magasin.

Encaisser et reverser

Les mêmes produits que n'importe quel partenaire Jèko.

Retenir un encaissement

Pot, puis libération ou remboursement par la clé plateforme.

Parcours

Nouveau compte, ou rattachement si le téléphone existe déjà.
KYC, puis KYB.
Clé plateforme. Jèko crée le magasin dédié au rattachement.
Catalogue de frais et webhook.
Encaissement et reversement. Pour retenir les fonds jusqu'à votre feu vert, escrow.

Authentification

Tous les endpoints utilisent la clé de l'entreprise Service Provider :

X-API-KEY: your_api_key_here
X-API-KEY-ID: your_api_key_id_here

Le compte Service Provider n'est pas créé en autonomie. Écrivez à hello@jeko.africa, puis suivez l'introduction.