MerchantFeesDto
Le MerchantFeesDto (Objet de Transfert de Données des Frais pour les marchands) définit la structure des frais appliqués aux opérations financières effectuées via l'API NoWallet.
Il est conçu pour représenter les frais appliqués aux marchands en fonction du pays, de la devise, de l'opérateur mobile et de la plage de montants des transactions. Ce DTO est essentiel pour configurer et afficher les coûts des transactions pour différents services.
Exemple de Réponse JSON
L'exemple JSON illustre un objet typique MerchantFeesDto. Il spécifie des frais fixes pour les opérations de dépôt (cash-in), de retrait (cash-out) et pour les transactions marchandes, tous fixés à 2,1 %. Il inclut également des métadonnées telles que le pays (CM pour le Cameroun), la devise (XAF) et l'opérateur mobile (MTN). Le tableau rangefees contient une règle de frais qui s'applique aux transactions comprises entre 100 et 1000 unités, démontrant la capacité de l'API à définir des structures de frais par paliers.
{
"fee_cashin": 2.1,
"fee_cashout": 2.1,
"fee_merchant": 2.1,
"country": "CM",
"currency": "XAF",
"operator": "MTN",
"rangefees": [
{
"min": 100,
"max": 1000,
"fee": 2.1
}
]
}
Propriétés
La section Propriétés fournit des explications détaillées pour chaque champ :
- fee_cashin: Le pourcentage de frais appliqué lors du dépôt de fonds (cash-in), spécifique au pays et à l'opérateur.
- fee_cashout: Le pourcentage de frais appliqué lors du retrait de fonds (cash-out), spécifique au pays et à l'opérateur.
- fee_merchant: Le pourcentage de frais opérationnels pour les transactions liées aux marchands, spécifique au pays et à l'opérateur.
- country: Un code à deux lettres identifiant le pays dans lequel les règles de frais s'appliquent.
- currency: La devise utilisée pour les transactions dans le pays spécifié.
- operator: Le nom de l'opérateur de mobile money ou de télécommunications auquel les frais s'appliquent.
- rangefees: Un tableau qui définit des plages de frais dynamiques en fonction des montants minimum et maximum des transactions, permettant un contrôle plus granulaire sur les frais appliqués.
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| fee_cashin | number | true | aucune | Frais de dépôt (cash-in) par pays et opérateur and per operator |
| fee_cashout | number | true | aucune | Frais de retrait (cash-out) par pays et opérateur |
| fee_merchant | number | true | aucune | Frais marchands par pays et opérateur |
| country | string | true | aucune | Code du pays où les frais s'appliquent |
| currency | string | true | aucune | Code de la devise où les frais s'appliquent |
| operator | string | true | aucune | Opérateur auquel les frais s'appliquent |
| rangefees | array | true | aucune | Plages de frais par pays |
Cette structure permet des configurations de frais précises adaptées à différents contextes régionaux et opérationnels, ce qui la rend hautement flexible pour divers marchés africains.
Cette page vous a-t-elle été utile ?