Les frais appliqués à un encaissement ou un transfert Partner API suivent la clé utilisée.
| Clé | Tarif | Remboursement |
|---|---|---|
| Clé créée par le marchand | Barème Partner API Kelyko | Selon les règles habituelles du moyen de paiement |
| Clé créée par le plateforme, tant que le marchand est toujours rattaché | Ligne du catalogue de frais assigné à ce marchand pour ce moyen de paiement et ce sens (cash-in ou cash-out). Sans catalogue assigné, ou sans ligne pour ce moyen, le barème Kelyko du marchand s'applique | Non remboursable |
Le plateforme n'est rémunéré sur une opération que lorsque les frais viennent d'une ligne de son catalogue assigné. Un marchand sans catalogue assigné paie son barème Kelyko, et le plateforme ne perçoit rien sur ces opérations.
Si le marchand quitte le plateforme, les nouvelles opérations faites avec une ancienne clé SP repassent au barème Kelyko. Les opérations déjà créées gardent le tarif et l'initiateur figés au moment de la création.
Le champ fees renvoyé par l'API Partner est le montant facturé au marchand. Il n'expose pas le partage interne entre Kelyko et le plateforme.
Catalogues
Vous créez vos catalogues depuis votre tableau de bord. Il n'y a pas d'endpoint Partner pour les créer. Chaque catalogue a un nom et une ligne par moyen de paiement et par sens (cash_in ou cash_out). Chaque ligne doit être au moins égale au tarif Partner API Kelyko, avec le même type de prix (pourcentage ou fixe).
Un catalogue ne se modifie pas : pour changer un prix, créez un nouveau catalogue et assignez-le. Un catalogue encore assigné à un marchand ne peut pas être supprimé depuis le tableau de bord (fee_catalog_still_assigned, 409). Retirez-le d'abord, ou détachez le marchand.
Assigner un catalogue à un marchand
Assignez un catalogue à un marchand rattaché. L'appel remplace toute assignation live précédente pour ce couple plateforme et marchand.
PUT /partner_api/service_providers/business_links/{merchantBusinessId}/fee_catalog
{
"feeCatalogId": "c4a1e8f2-5b3d-4e7a-9f10-2d6b8c0e1a34"
}
Réponse (200) : l'assignation active.
{
"id": "7d2f9b1c-8e4a-4c3d-b6f5-1a0e9c8d7b62",
"serviceProviderBusinessId": "a0b1c2d3-e4f5-6789-abcd-ef0123456789",
"merchantBusinessId": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
"serviceProviderFeeCatalogId": "c4a1e8f2-5b3d-4e7a-9f10-2d6b8c0e1a34",
"createdAt": "2026-09-25T12:00:00.000Z",
"updatedAt": "2026-09-25T12:00:00.000Z"
}
Les opérations déjà créées gardent les frais calculés à leur création. Seules les nouvelles opérations utilisent le nouveau catalogue.
Quand vos clés initient une opération pour ce marchand :
- si le catalogue assigné a une ligne pour ce moyen de paiement et ce sens, c'est cette ligne qui est facturée ;
- sinon (pas de catalogue assigné, ou pas de ligne pour ce moyen), le barème Kelyko du marchand s'applique.
Vous n'êtes rémunéré que dans le premier cas.
Retirer le catalogue
DELETE /partner_api/service_providers/business_links/{merchantBusinessId}/fee_catalog
Réponse (200) : l'assignation qui vient d'être retirée. Le marchand repasse alors à son barème Kelyko pour les opérations que vous initiez, et vous ne percevez plus rien sur ces opérations.
Le détachement retire aussi le catalogue assigné.
id d'erreur |
HTTP | Signification |
|---|---|---|
not_linked |
404 | Aucun rattachement live entre vous et ce merchantBusinessId (PUT) |
fee_catalog_not_found |
404 | Le catalogue n'existe pas, ne vous appartient pas, ou a été supprimé (PUT) |
fee_catalog_assignment_not_found |
404 | Aucun catalogue n'est assigné à ce marchand (DELETE) |
fee_catalog_still_assigned |
409 | Suppression d'un catalogue encore assigné, depuis le tableau de bord |
Les autres codes sont regroupés dans Erreurs.