Introduction à l’offre plateformes

Point d’attention.

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

Le programme plateforme s'adresse aux marketplaces et aux agrégateurs de paiement qui veulent proposer le portefeuille Kelyko à 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 Kelyko (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 plateforme 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 Plateformes.

Qu'est-ce qu'un plateforme ?

Un plateforme est une entreprise qui agit comme intermédiaire entre Kelyko 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

Les trois objets du programme

plateforme Business

Un plateforme Business est un type spécial de compte entreprise dans Kelyko. 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 plateforme 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 Kelyko.

plateforme 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

Ce que chacun y gagne

Pour les Plateformes

• 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 Kelyko à 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 Kelyko
• Des clés API pour intégrer les paiements à leurs propres systèmes

Comment les comptes s'articulent

Modèle de relation

plateforme 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 plateforme
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 plateforme et marchand
5. Catalogue de frais : un catalogue assigné par marchand rattaché

Le cas d'une marketplace

Intégration Marketplace

Les plateformes de marketplace peuvent intégrer leurs vendeurs en tant que marchands, leur permettant d'accepter des paiements directement via Kelyko 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

Suspension

Kelyko peut suspendre un plateforme, puis le réactiver. Les rattachements, les clés plateforme, les magasins et les paiements déjà initiés restent en place. Un marchand déjà détaché le reste.

Tant que le compte est suspendu :

• /partner_api/service_providers/* répond 403 avec l'id business_not_service_provider
• une clé plateforme créée pour un marchand répond aussi 403. Elle ne redevient pas une clé marchand sans restriction
• les webhooks du magasin dédié ne partent plus. L'abonnement n'est pas supprimé
• la clé de votre entreprise continue d'appeler les routes Partner qui ne sont pas réservées au plateforme

La réactivation restaure les mêmes rattachements et les mêmes clés. Les webhooks du magasin dédié reprennent sur la même URL.

Pour commencer

1. Contactez Kelyko : le compte plateforme n'est pas créé en autonomie, écrivez à contact-a-renseigner@kelyko.invalid
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.