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 uniquement la création des comptes marchands et de leurs clés API. Une fois intégré, un marchand encaisse et transfère avec les mêmes API que n'importe quel partenaire : rien n'est spécifique aux Service Providers de ce côté.

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

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 et révoquez les clés API de vos marchands
• 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
    │   └── Peut gérer les clés API pour Merchant 1
    │
    ├── Membre ServiceProvider → Merchant Business 2
    │   └── Peut gérer les clés API pour Merchant 2
    │
    └── Membre ServiceProvider → Merchant Business N
        └── Peut gérer les clés API pour Merchant N

Composants clés

1. Partner API : Endpoints API dédiés pour les fournisseurs de services
2. Authentification par clé API : Les fournisseurs de services s'authentifient à l'aide de clés API
3. Rôles de membres d'entreprise : Rôle ServiceProvider spécial pour le contrôle d'accès
4. Suivi des références : Les codes de référence lient les marchands à leur fournisseur de services

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 (fournisseur de services) intègre un nouveau vendeur
2. Le vendeur reçoit un compte marchand avec accès API
3. Le vendeur intègre les paiements dans sa boutique
4. La marketplace peut gérer les clés API du vendeur si nécessaire

Pour commencer

Pour devenir un Service Provider :

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. Intégrez vos marchands : suivez le guide d'intégration

Ensuite, chaque marchand utilise ses propres clés avec le reste de la documentation : Paiements, Transferts et Webhooks.