- Directives d'intégration
- Fonctionnalités prises en charge (Autres fonctionnalités)
- Informations de financement et de frais
Informations de financement et de frais
Mastercard Gateway propose une prise en charge des informations de financement et de frais fournies par votre fournisseur de services de paiement. La responsabilité de l'exactitude de ces informations incombe au fournisseur de services de paiement.
Les informations de financement et de frais font référence au mouvement réel des fonds effectué par le fournisseur de services sur votre compte bancaire. Le financement peut être positif (financement pour une opération Payment (Paiement) ou Capture) ou négatif (financement pour une opération Refund (Remboursement)). Les frais sont toujours négatifs. Ce qui signifie, qu'ils sont débités de votre compte bancaire.
Conditions préalables
Les informations de financement et de frais ne sont disponibles que pour les commandes et les transactions pour lesquelles votre fournisseur de services a fourni les informations sur Mastercard Gateway.
Comment extraire les informations de financement et de frais
Si les informations de financement et de frais sont fournies par votre fournisseur de services, vous pouvez les extraire de Mastercard Gateway via :
- Une demande API
RETRIEVE_ORDER
ouRETRIEVE_TRANSACTION
- Un rapport de transactions via l'API Reporting (API de rapports)
- L'exportation de la commande ou de la transaction à partir de l'Administration du commerçant
Vous pouvez également vous inscrire pour les notifications Webhook afin de connaître les mises à jour.
Financement de transaction
Les informations sur le financement d'une transaction sont enregistrées par rapport la transaction, notamment le montant et la devise de financement, dans les champs d'API suivants :
transaction.funding.amount
transaction.funding.currency
Le financement pour :
- une transaction Payment (Paiement) ou Capture est crédité sur votre compte, et le montant de financement est donc positif ;
- une transaction Refund (Remboursement) est débité de votre compte, et le montant de financement est donc négatif.
Statut de financement de la transaction
En fonction des informations de financement d'une transaction, le statut de financement de la transaction est mis à jour comme suit :
Champ API | Statut | Description |
---|---|---|
transaction.funding.status |
NOT_SUPPORTED |
La transaction a été réglée par une institution de laquelle Mastercard Gateway ne reçoit aucune information de financement. |
NON_FUNDED |
La transaction ne peut pas entraîner de transfert d'argent vers ou de votre compte. Cela s'applique aux transactions VERIFICATION ou AUTHORIZATION . |
|
IN_PROGRESS |
La transaction entraîne un transfert d'argent vers ou de votre compte, mais celui-ci n'a pas encore eu lieu. Il s'agit généralement d'un état transitoire. | |
FUNDING_ASSURED |
Le règlement de la transaction est garanti, mais n'a pas encore été effectué. | |
FUNDED |
La transaction a maintenant réglé l'argent sur votre compte. | |
FUNDING_ON_HOLD |
La transaction peut entraîner un transfert d'argent vers / de votre compte ; cependant, le fournisseur financier ne peut pas terminer le transfert des fonds en raison d'un problème sur votre compte. Il peut s'agir d'un état transitoire. | |
FUNDING_FAILED |
La transaction peut entraîner un transfert d'argent vers / de votre compte ; cependant le fournisseur de services n'a pas encore reçu les fonds du payeur. Dans le cas d'un remboursement, le fournisseur de services n'a pas pu transférer les fonds au payeur. | |
FUNDING_ADJUSTED |
Un montant précédemment financé pour la commande a été ajusté. L’ajustement peut consister en un crédit ou un débit sur votre compte. |
Date de financement
Mastercard Gateway fournit au moins l'une des dates suivantes, indiquant quand le financement a eu lieu ou doit avoir lieu :
Champ API | Description |
---|---|
transaction.funding.date |
Date à laquelle les fonds arrivent sur votre compte bancaire. Ce champ n'est renseigné que si la date est connue de manière certaine. |
transaction.funding.initiatedDate |
Date à laquelle l'acquéreur a initié le transfert de fonds vers votre compte bancaire. Ce champ n'est renseigné que si la date d'engagement et la date de financement réel ne sont pas disponibles. |
transaction.funding.estimatedDate |
Date à laquelle l'acquéreur estime que les fonds doivent arriver sur votre compte bancaire. Ce champ n'est renseigné que si la date est connue de manière certaine, mais la date à laquelle les fonds doivent arriver sur votre compte (transaction.funding.date ) est incertaine. |
La date renseignée dépend des informations fournies par l'acquéreur. Cependant :
- Au moins une de ces dates est disponible.
- En règle générale, ces dates ne sont pas toutes disponibles.
transaction.acquirer.timeZone
).Quand le statut de financement d'une transaction est-il mis à jour ?
Mastercard Gateway met à jour le statut de financement d'une commande lorsqu'elle reçoit les informations de l'acquéreur indiquant que le financement a eu lieu pour une transaction.
Quand l'expédition des marchandises est-elle sans risque ?
Le statut de financement d'une transaction FUNDING_ASSURED
ou FUNDED
indique que vous pouvez sans risque expédier les marchandises au payeur.
Échec du financement
Si le financement d'une transaction Payment (Paiement) ou Capture a échoué, l'acquéreur peut rappeler les fonds. Ce qui signifie qu'il les débite de votre compte bancaire. Dans ce cas, une transaction avec le type de transaction FUNDING
est créée sur la commande pour la transaction pour laquelle le financement a échoué. Cette transaction a un montant à zéro et la même devise que celle dans laquelle le financement a eu lieu (devise de règlement). Le montant du financement est négatif.
Si le financement d'une transaction Refund (Remboursement) a échoué, l'acquéreur peut vous retourner les fonds. Par exemple, si les fonds n'ont pas pu être retournés au payeur car le compte de celui-ci est fermé. Dans ce cas, une transaction avec le type de transaction FUNDING
est créée sur la commande pour la transaction pour laquelle le financement a échoué. Cette transaction a un montant à zéro et la même devise que celle dans laquelle le financement a eu lieu (devise de règlement). Le montant du financement est positif.
Statut de financement de la commande
Le statut de financement reflète le statut actuel du financement pour l'argent que vous pouvez raisonnablement prévoir pour cette commande. Il reflète l'agent versé sur et provenant de votre compte bancaire. C'est-à-dire les ventes et les remboursements.
Le statut de financement de la commande (order.fundingStatus
) est déterminé à partir du statut de financement (transaction.funding.status
) des transactions affectées à la commande.
Lorsqu'elle examine le statut de financement, Mastercard Gateway ne traite que les transactions qui peuvent transférer des fonds. Par exemple, elle ignore les autorisations, ainsi que les captures refusées. Cela vient du fait que le statut de financement de la commande reflète le mouvement d'argent pour la transaction commerciale, mais il ne reflète pas le mouvement d'argent pour les frais associés à la transaction.
Champ API | Statut | Description |
---|---|---|
order.fundingStatus |
NOT_SUPPORTED |
Toutes les transactions de la commande ont été réglées par un fournisseur de paiements duquel Mastercard Gateway ne reçoit aucune information de paiement. |
NON_FUNDED |
Aucune transaction n'est effectuée sur la commande pouvant entraîner un transfert d'argent vers ou de votre compte. | |
IN_PROGRESS |
Des transactions sont effectuées sur la commande pouvant entraîner un transfert d'argent vers / de votre compte, mais certaines ne sont pas encore terminées. Il s'agit généralement d'un état transitoire. | |
FUNDING_ASSURED |
Le règlement de toutes transactions pouvant entraîner un transfert d'argent vers ou de votre compte est garanti, mais n'a pas encore été effectué. Lors de cet état, le montant exact des fonds à transférer peut ne pas être connu. | |
FUNDED |
Toutes transactions pouvant entraîner un transfert d'argent vers ou de votre compte sont compensées et seront réglées. | |
FUNDING_FAILED |
Des transactions sont effectuées sur la commande pouvant entraîner un transfert d'argent vers ou de votre compte ; cependant, le fournisseur de services ne peut pas terminer le transfert des fonds en raison d'un problème sur votre compte. Il peut s'agir d'un état transitoire. | |
FUNDING_ON_HOLD |
Des transactions sont effectuées sur la commande pouvant entraîner un transfert d'argent vers ou de votre compte ; cependant le fournisseur de services n'a pas encore reçu les fonds du payeur. Dans le cas d'une commande avec un remboursement, le fournisseur de services n'a pas pu retourner les fonds au payeur. Vous devez contacter le payeur afin de débloquer cette situation. |
Montant de financement de la commande
Le montant de financement de la commande (order.funding.amount
) reflète le montant total financé sur ou de votre compte bancaire pour cette commande (comme indiqué à Mastercard Gateway par votre acquéreur). Il s'agit notamment des ventes (crédits sur votre compte) et des remboursements (débits).
Reportez-vous au statut de financement de la commande (order.funding.status
) pour déterminer la certitude de cette valeur.
Devise de financement de la commande
La devise de financement de la commande (order.funding.currency
) est déterminée avec la même valeur que la devise de financement de la transaction (transaction.funding.currency
) de la première transaction financée pour une commande.
Informations de financement non fournies
Pour les transactions traitées via un acquéreur pour lesquelles les informations de financement ne sont pas fournies sur Mastercard Gateway, le statut de financement de la transaction est défini sur NOT_SUPPORTED
.
Frais
Il y a trois types de frais d'acquéreur :
- Frais de la transaction Par exemple, frais d'interchange.
- Frais liés à un événement. Par exemple, frais d'enquête pour fraude et frais de virement.
- Frais du commerçant. Par exemple, frais de configuration du commerçant, frais mensuels du commerçant et frais mensuels minimums du commerçant.
Frais de la transaction.
Les informations sur les frais applicables pour une transaction sont fournies par rapport la transaction dans les champs d'API suivants :
transaction.funding.fee[n].feeType
transaction.funding.fee[n].acquirerFeeName
transaction.funding.fee[n].amount
transaction.funding.fee[n].rate
Les montants des frais sont débités de votre compte par l'acquéreur mais sont des montants positifs dans l'API.
Frais de commerçant et d'événement
Les informations sur les frais applicables pour un commerçant ou un événement sont fournies par rapport à un ordre de financement autonome.
Un ordre de financement autonome comporte les détails de commande suivants :
Champ de la commande | Description |
---|---|
order.id |
ID émis par Mastercard Gateway. |
order.amount |
0 |
order.currency |
Défini avec la devise de règlement des frais du commerçant ou de l'événement enregistrés. |
order.status |
Défini sur FUNDING_ONLY . |
order.fundingStatus |
Défini sur NON_FUNDED . |
sourceOfFunds.type |
Défini sur NONE . |
order.description |
Comporte une chaîne expliquant que cette commande ne contient que des informations de frais. |
Un ordre de financement autonome comporte également les détails de transaction suivants :
Champ de la transaction | Description |
---|---|
transaction.id |
ID émis par Mastercard Gateway. |
transaction.amount |
0 |
transaction.type |
Défini sur FUNDING . |
Groupe de paramètres transaction.funding.fee[n] |
Informations sur les frais. |
Si les frais du commerçant ou de l'événement sont fournis par l'acquéreur pour un commerçant donné avec un ID acquéreur associé à plusieurs commerçants sur Mastercard Gateway, les informations ne sont enregistrées qu'une seule fois (par rapport à un seul profil de commerçant).
transaction.acquirer.id
).Montant des frais de la transaction
Le montant des frais de la transaction (transaction.funding.feeAmount
) est fourni dans la devise de règlement (transaction.funding.feeCurrency
) et reflète le montant total des frais débités de votre compte bancaire pour cette transaction (comme indiqué à Mastercard Gateway par votre acquéreur).
Le montant des taxes peut être fourni avec un maximum de 4 décimales (indépendamment de l’exposant de la devise). Par conséquent, en raison des arrondis appliqués aux montants, le montant total des frais pour la transaction peut ne pas correspondre à la somme de tous les frais.