Introduction

Vue d'ensemble

Le programme Service Provider s'adresse aux marketplaces et aux agrégateurs de paiement qui veulent proposer le portefeuille Jèko à leurs marchands. Vous intégrez vos marchands par appel API et gérez leurs clés, sans qu'ils aient à construire leur propre infrastructure de paiement.

Le programme couvre la création des comptes marchands et le rattachement des marchands qui ont déjà un compte Jèko (demande de consentement, puis approbation par le Owner ou le Director). Une fois le lien établi, un marchand encaisse et transfère avec les mêmes API que n'importe quel partenaire. Les tarifs et le droit au remboursement dépendent de la clé qui initie l'opération : le détail est dans Tarifs et catalogues.

Deux clés interviennent. La clé de votre entreprise Service Provider appelle /partner_api/service_providers/*. La clé plateforme, que vous émettez pour le marchand, encaisse, transfère et gère l'escrow. La carte des pages est sur Service Providers.

Qu'est-ce qu'un Service Provider ?

Un Service Provider est une entreprise qui agit comme intermédiaire entre Jèko et les marchands finaux. Les fournisseurs de services sont généralement :

• Plateformes de marketplace (par ex., marketplaces e-commerce)
• Agrégateurs de paiement (par ex., prestataires de services de paiement)
• Plateformes Fintech qui souhaitent offrir des fonctionnalités de portefeuille à leurs marchands
• Fournisseurs Platform-as-a-Service qui intègrent des capacités de paiement

Concepts clés

Service Provider Business

Un Service Provider Business est un type spécial de compte entreprise dans Jèko. Cette entreprise :

• Peut intégrer des entreprises marchandes via l'API
• Peut créer et gérer des clés API pour les marchands intégrés
• Accède aux endpoints Service Provider de la Partner API avec ses propres clés API
• Garde le lien avec tous les marchands qu'elle a intégrés, et peut les lister ou les détacher

Merchant Business

Une Merchant Business est un compte entreprise standard, intégré par un fournisseur de services. Ces entreprises encaissent des paiements via Jèko.

Service Provider Business Member

Un membre ServiceProvider est un rôle spécial qui :

• Lie une entreprise fournisseur de services à une entreprise marchande
• Ne nécessite pas d'utilisateur
• Accorde au fournisseur de services l'autorisation de gérer les clés API pour ce marchand

Avantages du programme Service Provider

Pour les Service Providers

• Intégrez vos marchands par appel API, sans intervention manuelle
• Créez les clés API de vos marchands (le détachement les révoque)
• Listez les rattachements live et détachez un marchand
• Assignez un catalogue de frais par marchand
• Intégrez le portefeuille Jèko à votre plateforme existante

Pour les Marchands

• Un compte opérationnel sans démarche d'inscription séparée
• L'accès à toutes les méthodes de paiement Jèko
• Des clés API pour intégrer les paiements à leurs propres systèmes

Architecture

Modèle de relation

Service Provider Business
    │
    ├── Membre ServiceProvider → Merchant Business 1
    │   └── Magasin dédié, clés plateforme, catalogue de frais
    │
    ├── Membre ServiceProvider → Merchant Business 2
    │   └── Magasin dédié, clés plateforme, catalogue de frais
    │
    └── Membre ServiceProvider → Merchant Business N
        └── Magasin dédié, clés plateforme, catalogue de frais

Composants clés

1. Partner API : endpoints dédiés sous /partner_api/service_providers
2. Authentification par clé API : la clé de l'entreprise Service Provider
3. Rôles de membres d'entreprise : rôle ServiceProvider pour le contrôle d'accès
4. Magasin dédié : un magasin par couple Service Provider et marchand
5. Catalogue de frais : un catalogue assigné par marchand rattaché

Cas d'usage

Intégration Marketplace

Les plateformes de marketplace peuvent intégrer leurs vendeurs en tant que marchands, leur permettant d'accepter des paiements directement via Jèko tandis que la marketplace gère l'intégration.

Flux d'exemple :

1. La marketplace intègre un nouveau vendeur, ou rattache un vendeur déjà inscrit
2. Le vendeur reçoit un compte marchand et une clé plateforme
3. La marketplace encaisse sur le magasin dédié, ou le vendeur intègre les paiements dans sa boutique
4. La marketplace peut détacher le vendeur : les clés qu'elle a créées cessent alors de fonctionner

Pour commencer

1. Contactez Jèko : le compte Service Provider n'est pas créé en autonomie, écrivez à hello@jeko.africa
2. Obtenez vos identifiants API : vous recevez votre clé API Partner et son identifiant
3. Suivez le parcours : intégration ou rattachement, puis conformité, clés, frais et webhooks

Ensuite, la clé plateforme utilise le reste de la documentation : Paiements, Transferts et Webhooks. Pour retenir un encaissement jusqu'à votre feu vert, voir Escrow.