Grille tarifaire

Frais appliqués par corridor de pays pour les collections (PayIn) et les payouts (PayOut).

Modèle de tarification

Pourcentage

Frais calculés en proportion du montant.

frais = montant × (taux / 100)
ex : 1.5% de 10 000 XOF = 150 XOF

Fixe

Montant constant quelle que soit la valeur de la transaction.

frais = valeur_fixe
ex : 200 XOF systématiquement

Devise pivot : Tous les calculs utilisent le XOF (Franc CFA) comme base. Les montants en d'autres devises sont convertis via le taux en vigueur.

Pour les Payouts : les frais sont ajoutés au montant, prélevés sur votre wallet. Le bénéficiaire reçoit le montant exact saisi.

Pour les Collections : les frais sont déduits du montant reçu par le marchand.

Calculer les frais via l'API

Obtenez les frais exacts en temps réel avant d'initier une transaction. Passez directement le code ISO du pays (ex : bj, sn) — aucun ID interne requis.

curl -X GET "https://newapi.sebpay.bj/api/v1/c/calculate-fee?amount=10000&source_country=bj&destination_country=sn&transaction_type=collection"

Réponse

{
  "success": true,
  "data": {
    "fee_amount": 200.00
  },
  "message": "Fee calculated successfully."
}

Frais de retrait (comptes professionnels multi-devises uniquement)

Les comptes standards n'ont jamais eu de frais de retrait. Pour un compte professionnel multi-devises (wallet_mode=multiwallet), des frais de retrait peuvent s'appliquer en plus des frais de payout, configurés par pays. Ils sont déduits immédiatement à la demande du retrait, en même temps que le montant retiré.

Tarifs de conversion entre wallets

Convertir des fonds d'un wallet vers un autre (ex: XOF → XAF) sur un compte professionnel multi-devises applique des frais configurés par paire de devises, indépendants de la grille tarifaire par pays ci-dessus.

ParamètreDescription

source_currency_id / destination_currency_idLes devises source et destination de la conversion.

fee_typefixed ou percentage.

fee_valueLe montant fixe ou le taux appliqué au montant source.

min_amount / max_amountBornes optionnelles sur le montant source éligible.

frais = calcul(fee_type, fee_value, montant_source)

montant_net = montant_source - frais

montant_destination = montant_net converti au taux de change source→destination

Il n'y a pas de conversion gratuite implicite : si aucune règle de frais n'est configurée pour une paire de devises, la conversion est refusée plutôt que traitée gratuitement.

Note importante

Les frais indiqués sont indicatifs et peuvent varier selon les accords commerciaux. Utilisez GET /calculate-fee pour obtenir les frais exacts en temps réel.