Une fois la clé plateforme créée, le marchand utilise la Partner API comme n'importe quel partenaire Kelyko. Les en-têtes sont les mêmes, X-API-KEY et X-API-KEY-ID, avec cette clé, pas la clé de votre entreprise plateforme.
Les appels opèrent sur votre magasin dédié. Omettez storeId, ou reprenez l'identifiant renvoyé par GET /partner_api/stores.
Encaisser
| Produit | Quand | Guide |
|---|---|---|
| Paiement en ligne | Tunnel que vous contrôlez, page hébergée par Kelyko | Checkout |
| API direct | Vous connaissez le numéro du payeur et vous construisez l'écran | API direct |
| Lien de paiement | Facture, WhatsApp, SMS, collecte | Liens de paiement |
Le champ fees de la réponse est le montant facturé au marchand. Avec une clé plateforme, le barème vient du catalogue assigné, et l'opération n'est pas remboursable. Sans catalogue, ou sans ligne pour ce moyen, le barème Kelyko du marchand s'applique et vous n'êtes pas rémunéré.
Reverser
Transferts : envoi vers Mobile Money ou compte bancaire, débité du même magasin. Le sens cash-out suit le même catalogue.
Être notifié
Événements : TRANSACTION_COMPLETED est le corps plat d'une transaction terminée. Les autres Kelyko-Event (rattachement, escrow, conformité) sont sur la même page. Créez l'abonnement avec la clé plateforme, voir Webhooks marchand.
Pour retenir le net jusqu'à votre feu vert au lieu de créditer le solde opérable, créez un pot et lancez son encaissement avec POST /partner_api/escrows/{id}/collect. Seule la clé plateforme peut le faire. Voir Escrow.