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 qui proposent le portefeuille Kelyko à leurs marchands. Vous intégrez ces marchands par appel API, avec la clé de votre entreprise plateforme. 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 plateforme | Intégrer, rattacher, vérifier, créer des clés et des webhooks, assigner un catalogue de frais | /partner_api/service_providers/* |
| 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
Parcours
- Nouveau compte, ou rattachement si le téléphone existe déjà.
- KYC, puis KYB.
- Clé plateforme. Kelyko 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.
<Mermaid chart="`sequenceDiagram participant SP as plateforme participant API as Kelyko Partner API participant Merchant as Marchand
SP->>API: GET /service_providers/locations SP->>API: GET /service_providers/activities SP->>API: POST /service_providers/business_onboarding alt Téléphone déjà inscrit (409) SP->>API: POST /service_providers/business_link_requests Note over Merchant,API: Le Owner ou le Director approuve dans l'app SP->>API: GET /service_providers/business_link_requests/{id} end SP->>API: POST /service_providers/compliance_verifications SP->>API: POST /service_providers/business_api_keys SP->>API: PUT .../business_links/{id}/fee_catalog SP->>API: POST /service_providers/business_webhook_subscriptions Note over SP,API: La clé plateforme encaisse et transfère ensuite`" />
Authentification
Tous les endpoints /partner_api/service_providers/* utilisent la clé de l'entreprise plateforme :
X-API-KEY: your_api_key_here
X-API-KEY-ID: your_api_key_id_here
Le compte plateforme n'est pas créé en autonomie. Écrivez à contact-a-renseigner@kelyko.invalid, puis suivez l'introduction.