Tarifs et catalogues

Quel barème s'applique selon la clé, et comment assigner un catalogue de frais à un marchand

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 Jèko	Selon les règles habituelles du moyen de paiement
Clé créée par le Service Provider, 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 Jèko du marchand s'applique	Non remboursable

Le Service Provider 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 Jèko, et le Service Provider ne perçoit rien sur ces opérations.

Si le marchand quitte le Service Provider, les nouvelles opérations faites avec une ancienne clé SP repassent au barème Jèko. 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 Jèko et le Service Provider.

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 Jèko, 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 Service Provider 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 Jèko 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 Jèko 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.

Catalogues

Assigner un catalogue à un marchand

Retirer le catalogue

On this page