logo Mercanet

Release 24.3

aller directement au contenu

Rechercher par mots clés

walletCredit (batch)

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Cette fonction vous permet de créditer vos clients via leur wallet sans transaction préalable.

Obligatoire

Optionnel

  • customerEmail
    présence
    Optionnel
    Interface version
    4
    Ordre
    8

    Déprécié, remplacé par “email” du container customerContact.

  • customerId
    présence
    Optionnel
    Interface version
    4
    Ordre
    9

    Identifiant du client

    Attention : utiliser ce champ libre uniquement pour l’usage prévu, et par conséquent ne pas y insérer des données à caractère personnel, et plus particulièrement des données de porteur de carte. En cas de non-respect de cette consigne BNP Paribas ne serait être tenu responsable d’un point de vu légal, de tout incident qui pourrait survenir.

    En tant que sous-traitant, BNP Paribas traite les données à caractère personnel conformément aux Conditions de Traitement des Données à Caractère Personnel (CTDCP), annexées à tous les contrats.

    Ainsi :

    • Les données personnelles prévues par le CTDCP doivent uniquement être transmises à BNP Paribas au travers des champs prévus à cet effet (cf. dictionnaire des données).
    • Toutes autres données à caractère personnel non listées dans le CTDCP ne doivent pas être transmises à BNP Paribas
  • customerIpAddress
    présence
    Optionnel
    Interface version
    4
    Ordre
    10

    Adresse IP de l’acheteur.

  • merchantLocationId
    présence
    Optionnel
    Interface version XML
    20
    Interface version CSV
    20
    Ordre
    19

    Donnée du commerçant identifiant l’emplacement de sa boutique.

  • orderChannel
    présence
    Optionnel
    Interface version
    4
    Ordre
    11

    Canal de commande utilisé (Internet, Téléphone, Courrier, Fax, …), Internet est la valeur par défaut.L’usage de ce champ est à rapprocher des conditions définies dans le contrat acquéreur.

    Liste des valeurs
    FAX
    Commande Fax Contrat d’acquisition : MOTO
    INAPP
    Commande par un service intégré à une application (mobile par exemple) Contrat d’acquisition : INTERNET
    INTERNET
    Commande Internet Contrat d’acquisition : INTERNET
    IVR
    Commande vocale Contrat d’acquisition : MOTO
    MAIL_ORDER
    Commande Courrier Contrat d’acquisition : MOTO
    MINITEL
    Obsolète
    MOTO
    Commande VAD sans précision (déprécié utilisez les valeurs MAIL_ORDER ou TELEPHONE_ORDER) Contrat d’acquisition : MOTO
    PROXI_ATTENDED
    Obsolète
    PROXI_SEMIATTENDED
    Obsolète
    PROXI_UNATTENDED
    Obsolète
    TELEPHONE_ORDER
    Commande Téléphone Contrat d’acquisition : MOTO
  • orderId
    présence
    Optionnel
    Interface version
    4
    Ordre
    12

    Numéro de commande associé à la transaction de paiement.

    Attention : utiliser ce champ libre uniquement pour l’usage prévu, et par conséquent ne pas y insérer des données à caractère personnel, et plus particulièrement des données de porteur de carte. En cas de non-respect de cette consigne BNP Paribas ne serait être tenu responsable d’un point de vu légal, de tout incident qui pourrait survenir.

    En tant que sous-traitant, BNP Paribas traite les données à caractère personnel conformément aux Conditions de Traitement des Données à Caractère Personnel (CTDCP), annexées à tous les contrats.

    Ainsi :

    • Les données personnelles prévues par le CTDCP doivent uniquement être transmises à BNP Paribas au travers des champs prévus à cet effet (cf. dictionnaire des données).
    • Toutes autres données à caractère personnel non listées dans le CTDCP ne doivent pas être transmises à BNP Paribas
  • returnContext
    présence
    Optionnel
    Interface version
    4
    Ordre
    13

    Contexte de la commande d’un acheteur.Toute information transmise dans ce champ par le commerçant lors de la requête de paiement est renvoyée dans la réponse sans modification.Attention : les caractères suivants “|”, “«”, “»”, et «”» sont à éviter dans ce champ. Si ces caractères sont utilisés, ils vous seront renvoyés tels quels, mais seront remplacés par des blancs dans les bases de données Mercanet.

    Attention : utiliser ce champ libre uniquement pour l’usage prévu, et par conséquent ne pas y insérer des données à caractère personnel, et plus particulièrement des données de porteur de carte. En cas de non-respect de cette consigne BNP Paribas ne serait être tenu responsable d’un point de vu légal, de tout incident qui pourrait survenir.

    En tant que sous-traitant, BNP Paribas traite les données à caractère personnel conformément aux Conditions de Traitement des Données à Caractère Personnel (CTDCP), annexées à tous les contrats.

    Ainsi :

    • Les données personnelles prévues par le CTDCP doivent uniquement être transmises à BNP Paribas au travers des champs prévus à cet effet (cf. dictionnaire des données).
    • Toutes autres données à caractère personnel non listées dans le CTDCP ne doivent pas être transmises à BNP Paribas
  • s10TransactionReference
    présence
    Optionnel
    Interface version
    4
    Ordre
    15

    Contient les informations sur l’identification de la transaction, compatible avec Mercanet 1.0.Contient le s10TransactionId / s10TransactionIdDate qui assure l’unicité de la transaction 1.0.

    Contient
  • settlementArchivingReference
    présence
    Optionnel
    Interface version XML
    13
    Interface version CSV
    13
    Ordre
    17

    Donnée fournie à l’acquéreur pour traitement des remises et des rapprochements. Par défaut générée par la plateforme Mercanet. Son alimentation par le commerçant est soumise à contraintes fortes. Contactez Mercanet pour utiliser cette donnée dans les requêtes.

  • settlementMerchantSpecificData
    présence
    Optionnel
    Interface version XML
    13
    Interface version CSV
    13
    Ordre
    18

    Données spécifiques fournies par le commerçant et transmises à l’acquéreur pour le traitement des remises. Contactez Mercanet pour utiliser cette donnée.

  • statementReference
    présence
    Optionnel
    Interface version XML
    10
    Interface version CSV
    10
    Ordre
    16

    Référence fournie par le commerçant qui est envoyée dans le flux de remise en paiement. Cette référence apparait sur les relevés de compte du porteur.A noter que pour les paiements CB, Visa et Mastercard via un acquéreur français, seuls les 32 premiers caractères de ce champ sont conservés et apparaissent sur le relevé de compte du porteur.

  • transactionOrigin
    présence
    Optionnel
    Interface version
    4
    Ordre
    14

    Origine d’une transaction (ex : nom du programme), valorisée par le commerçant. Exemple : “site Web A v1.32”.

  • transactionReference
    présence
    Optionnel
    Interface version
    4
    Ordre
    3

    Le commerçant a le choix d’identifier ses transactions par un transactionReference (mode par défaut) ou par un transactionId. transactionReference identifie de manière unique une transaction tout au long de la vie de la boutique.

Exemple de requête

            FILE;request;office;v19
HEADER;023101122334455;2021-12-16+0100;14:26:45+0100;1
WALLETCREDIT;12;023101122334456;SIM20220329092501;66;w01;paymentMeanId;978;customer@email.com;customerId;128.0.0.1;INTERNET;orderId;returnContext;origin;101;20210329;statementReference;settlementArchivingReference;settlementMerchantSpecificData
END;1

        
            <?xml version="1.0" encoding="UTF-8"?>
<file format="office" type="request" version="5">
	<header>
		<remitterId>023101122334455</remitterId>
		<date>2018-07-25+02:00</date>
		<time>09:00:00+01:00</time>
		<sequence>1</sequence>
	</header>
	<body>
		<walletCredit recordSequence="1">
            <merchantId>023101122334456</merchantId>
            <transactionReference>SIM20220329092501</transactionReference>
            <amount>66</amount>
            <merchantWalletId>w01</merchantWalletId>
            <paymentMeanId>paymentMeanId</paymentMeanId>
            <currencyCode>978</currencyCode>
            <customerEmail>customer@email.com</customerEmail>
            <customerId>customerId</customerId>
            <customerIpAddress>128.0.0.1</customerIpAddress>
            <orderChannel>INTERNET</orderChannel>
            <orderId>orderId</orderId>
            <returnContext>returnContext</returnContext>
            <transactionOrigin>origin</transactionOrigin>
            <s10TransactionReference>
                <s10TransactionId>101</s10TransactionId>
                <s10TransactionIdDate>20210329</s10TransactionIdDate>
            </s10TransactionReference>
            <statementReference>statementReference</statementReference>
            <settlementArchivingReference>settlementArchivingReference</settlementArchivingReference>
            <settlementMerchantSpecificData>settlementMerchantSpecificData</settlementMerchantSpecificData>
        </walletCredit>
	</body>
	<end nbRecord="1" />
</file>

        

Obligatoire

  • amount
    présence
    Obligatoire
    Interface version
    4
    Ordre
    4

    Montant de la transaction. Le montant doit être transmis dans la plus petite unité de la devise.Exemple pour l’Euro : un montant de 10,50 Euros doit être transmis sous la forme 1050.

  • currencyCode
    présence
    Obligatoire
    Interface version
    4
    Ordre
    7

    Code de la devise de la transaction. Ce code est compatible ISO 4217.

    Liste des valeurs
    032
    Peso argentin
    036
    Dollar australien
    048
    Dinar de Bahreïn
    116
    Riel cambodgien
    124
    Dollar canadien
    144
    Roupie sri lankaise
    156
    Yuan Renminbi
    191
    Kuna croate
    203
    Couronne tchèque
    208
    Couronne danoise
    344
    Dollar de Hong Kong
    348
    Forint hongrois
    352
    Couronne islandaise
    356
    Roupie indienne
    376
    Nouveau Shekel israélien
    392
    Yen japonais
    410
    Won coréen
    414
    Dinar koweïtien
    458
    Ringgit malaisien
    480
    Roupie de Maurice
    484
    Peso mexicain
    524
    Roupie népalaise
    554
    Dollar néo-zélandais
    578
    Couronne norvégienne
    634
    Rial qatari
    643
    Rouble russe
    682
    Riyal saoudien
    702
    Dollar de Singapour
    710
    Rand sud-africain
    752
    Couronne suédoise
    756
    Franc suisse
    764
    Baht thaïlandais
    784
    Dirham des Émirats arabes unis
    788
    Dinar tunisien
    826
    Livre Sterling
    840
    Dollar américain
    901
    Dollar de Taiwan
    941
    Dinar serbe
    946
    Leu roumain
    949
    Nouvelle livre turque
    952
    Franc CFA
    953
    Franc Pacifique
    975
    Lev bulgare
    978
    Euro
    980
    Hryvnia ukrainien
    985
    Zloty polonaise
    986
    Real brésilien
  • merchantId
    présence
    Obligatoire
    Interface version
    4
    Ordre
    2

    Identifiant de la boutique, sa valeur est fournie par Mercanet au commerçant lors de l’inscription de sa boutique.

  • merchantWalletId
    présence
    Obligatoire
    Interface version
    4
    Ordre
    5

    Identifiant du portefeuille virtuel du client.

  • officeBatchResponseCode
    présence
    Obligatoire
    Interface version
    4
    Ordre
    23

    officeBatchResponseCode complète le résultat du traitement d’une demande de paiement traitée par Office Batch qui serait rejetée (code de réponse classique de rejet) et contient le champ de la demande de paiement en erreur.

    Liste des valeurs
    00
    Aucun (tous les champs sont corrects).
    01
    merchantId error
    03
    transactionReference error
    04
    merchantTransactionDateTime error
    05
    amount error
    06
    captureDay error
    07
    captureMode error
    08
    operationAmount error
    09
    operationOrigin error
    11
    currencyCode error
    12
    customerIpAddress error
    13
    customerEmail error
    14
    customerId error
    16
    orderId error
    17
    orderChannel error
    18
    transactionOrigin error
    19
    returnContext error
    20
    fromTransactionReference error
    21
    cardExpiryDate error
    22
    cardNumber error
    23
    cardCSCValue error
    24
    cardEffectiveDate error
    25
    cardSeqNumber error
    26
    paymentMeanBrand error
    27
    authorisationId error
    28
    merchantWalletId error
    29
    paymentMeanId error
    30
    paymentPattern error
    31
    number error
    32
    statementReference error
    33
    panType error
    34
    mandateId error
    35
    valueDate error
    36
    paymentMeanAlias error
    37
    account error
    38
    bankCode error
    39
    transactionActors error
    45
    Date fields format error
    46
    settlementMode error
    47
    comment error
    48
    validationIndicator error
    50
    s10TransactionId error
    51
    s10TransactionIdDate error
    52
    s10FromTransactionId error
    53
    s10FromTransactionIdDate error
    54
    fraudData error
    55
    riskManagementDynamicParam error
    56
    riskManagementDynamicValue error
    57
    riskManagementDynamicSettingList error
    58
    fraudListReason error
    59
    fraudListType error
    60
    fraudListLevel error
    61
    fraudListElementType error
    62
    fraudListElementValue error
    63
    lastRecoveryIndicator error
    64
    orderContext error
    65
    travelContext error
    66
    deliveryData error
    67
    address error
    68
    contact error
    69
    cardAuthPolicy error
    70
    shoppingCartDetail error
    71
    merchantExternalId error
    72
    paymentMeansBrandSelectionStatus error
    73
    settlementArchivingReference error
    74
    settlementMerchantSpecificData error
    75
    fromTransactionAcceptor error
    80
    Commerçant non enregistré pour Office Batch /non lié au remettant déclaré dans l’en-tête.
  • paymentMeanId
    présence
    Obligatoire
    Interface version
    4
    Ordre
    6

    Rang du moyen de paiement au sein du wallet Mercanet.

  • recordSequence
    présence
    Obligatoire
    Interface version
    4
    Ordre
    1

    Ordre d’une transaction dans un fichier Office Batch.

Optionnel

  • acquirerResponseCode
    présence
    Optionnel
    Interface version
    4
    Ordre
    17

    Code réponse retourné par l’acquéreur lors d’une demande d’autorisation.

    Liste des valeurs
    00
    Transaction approuvée ou traitée avec succès
    02
    Contactez l’émetteur du moyen de paiement
    03
    Accepteur invalide
    04
    Conservez le support du moyen de paiement
    05
    Ne pas honorer
    07
    Conservez le support du moyen de paiement, conditions spéciales
    08
    Approuvez après l’identification
    12
    Transaction invalide
    13
    Montant invalide
    14
    Coordonnées du moyen de paiement invalides
    15
    Émetteur du moyen de paiement inconnu
    17
    Paiement interrompu par l’acheteur
    20
    Réponse erronée (erreur dans le domaine serveur)
    24
    Opération impossible
    25
    Transaction inconnue
    30
    Erreur de format
    31
    Id de l’organisation d’acquisition inconnu
    33
    Moyen de paiement expiré (Paypal / Cofidis)
    34
    Suspicion de fraude
    40
    Fonction non supportée
    41
    Moyen de paiement perdu
    43
    Moyen de paiement volé
    51
    Provision insuffisante ou crédit dépassé
    54
    Moyen de paiement expiré (CB / Visa / MC / WLAcq / BCMC)
    55
    PIN invalide
    56
    Moyen de paiement manquant dans le fichier
    57
    Transaction non autorisée pour ce porteur
    58
    Transaction interdite au terminal
    59
    Suspicion de fraude
    60
    L’accepteur du moyen de paiement doit contacter l’acquéreur
    61
    Excède le maximum autorisé
    62
    Transaction en attente de confirmation de paiement
    63
    Règles de sécurité non respectées
    65
    Nombre de transactions du jour dépassé
    68
    Réponse non parvenue ou reçue trop tard
    75
    Nombre de tentatives de saisie des coordonnées du moyen de paiement dépassé
    87
    Terminal inconnu
    90
    Arrêt momentané du système
    91
    Emetteur du moyen de paiement inaccessible
    92
    La transaction ne contient pas les informations suffisantes pour être redirigées vers l’organisme d’autorisation
    93
    La transaction n’a pas pu aboutir car non conforme à la réglementation
    94
    Transaction dupliquée
    96
    Mauvais fonctionnement du système
    97
    Requête expirée: transaction refusée
    98
    Serveur inaccessible
    99
    Incident technique
    A1
    Transaction refusée pour cause d’absence des données d’authentification 3-D Secure
    A4
    Transaction refusée pour cause de mauvaise utilisation de l’exemption d’authentification 3-D Secure
    R1
    Le porteur (ou sa banque) a révoqué les paiements récurrents effectués chez un commerçant
    R3
    Le porteur (ou sa banque) a révoqué tous les paiements récurrents
  • authorisationId
    présence
    Optionnel
    Interface version
    4
    Ordre
    18

    Identifiant d’autorisation, retourné par l’acquéreur si la demande d’autorisation est acceptée.

  • customerEmail
    présence
    Optionnel
    Interface version
    4
    Ordre
    8

    Déprécié, remplacé par “email” du container customerContact.

  • customerId
    présence
    Optionnel
    Interface version
    4
    Ordre
    9

    Identifiant du client

    Attention : utiliser ce champ libre uniquement pour l’usage prévu, et par conséquent ne pas y insérer des données à caractère personnel, et plus particulièrement des données de porteur de carte. En cas de non-respect de cette consigne BNP Paribas ne serait être tenu responsable d’un point de vu légal, de tout incident qui pourrait survenir.

    En tant que sous-traitant, BNP Paribas traite les données à caractère personnel conformément aux Conditions de Traitement des Données à Caractère Personnel (CTDCP), annexées à tous les contrats.

    Ainsi :

    • Les données personnelles prévues par le CTDCP doivent uniquement être transmises à BNP Paribas au travers des champs prévus à cet effet (cf. dictionnaire des données).
    • Toutes autres données à caractère personnel non listées dans le CTDCP ne doivent pas être transmises à BNP Paribas
  • customerIpAddress
    présence
    Optionnel
    Interface version
    4
    Ordre
    10

    Adresse IP de l’acheteur.

  • maskedPan
    présence
    Optionnel
    Interface version
    4
    Ordre
    19

    Numéro de PAN masqué. Dans le cas des portefeuilles virtuels, correspond au numéro de PAN masqué du moyen de paiement enregistré dans le portefeuille virtuel.

  • newStatus
    présence
    Optionnel
    Interface version
    4
    Ordre
    21

    Etat de la transaction mis à jour après une opération de caisse L’état d’une transaction est décrit par différents mots clés évoluant au fil des opérations qu’elle subit.

    Liste des valeurs
    ABORTED
    Transaction totalement abandonnée
    CANCELLED
    Transaction totalement annulée
    CAPTURED
    Transaction envoyée en banque
    CAPTURE_REFUSED
    Remise refusée
    CREDITED
    Transaction totalement remboursée
    ENDED
    Transaction terminée
    EXPIRED
    Transaction expirée
    PENDING
    Transaction en attente de la réponse à la demande d’autorisation
    PREPROD
    Transaction d’un commerçant qui est en mode Pré-production. Elle ne pourra pas être remisée.
    REFUSED
    Transaction refusée
    TO_AUTHORIZE
    Transaction en attente de demande d’autorisation
    TO_CAPTURE
    Transaction à envoyer en banque pour débiter l’internaute
    TO_CHALLENGE
    Transaction avec une suspicion de fraude
    TO_CONFIRM_AUTHOR
    Transaction en attente de confirmation d’autorisation.
    TO_CONFIRM_CAPTURE
    Transaction en attente de confirmation de remise.
    TO_CONFIRM_CREDIT
    Transaction en attente de confirmation de remboursement.
    TO_CREDIT
    Transaction à envoyer en banque pour créditer l’internaute
    TO_REPLAY
    Transaction en attente d’une validation avec demande d’autorisation
    TO_VALIDATE
    Transaction en attente de validation
    UNDEFINED
    Statut de la transaction non défini
    WAITING_AUTHOR
    Transaction extraite par les serveurs Mercanet pour réaliser une demande d’autorisation automatique à la fin du délai de capture différée
  • operationDateTime
    présence
    Optionnel
    Interface version
    4
    Ordre
    22

    Date et heure calculée par Mercanet à laquelle l’opération a été effectuée.

  • orderChannel
    présence
    Optionnel
    Interface version
    4
    Ordre
    11

    Canal de commande utilisé (Internet, Téléphone, Courrier, Fax, …), Internet est la valeur par défaut.L’usage de ce champ est à rapprocher des conditions définies dans le contrat acquéreur.

    Liste des valeurs
    FAX
    Commande Fax Contrat d’acquisition : MOTO
    INAPP
    Commande par un service intégré à une application (mobile par exemple) Contrat d’acquisition : INTERNET
    INTERNET
    Commande Internet Contrat d’acquisition : INTERNET
    IVR
    Commande vocale Contrat d’acquisition : MOTO
    MAIL_ORDER
    Commande Courrier Contrat d’acquisition : MOTO
    MINITEL
    Obsolète
    MOTO
    Commande VAD sans précision (déprécié utilisez les valeurs MAIL_ORDER ou TELEPHONE_ORDER) Contrat d’acquisition : MOTO
    PROXI_ATTENDED
    Obsolète
    PROXI_SEMIATTENDED
    Obsolète
    PROXI_UNATTENDED
    Obsolète
    TELEPHONE_ORDER
    Commande Téléphone Contrat d’acquisition : MOTO
  • orderId
    présence
    Optionnel
    Interface version
    4
    Ordre
    12

    Numéro de commande associé à la transaction de paiement.

    Attention : utiliser ce champ libre uniquement pour l’usage prévu, et par conséquent ne pas y insérer des données à caractère personnel, et plus particulièrement des données de porteur de carte. En cas de non-respect de cette consigne BNP Paribas ne serait être tenu responsable d’un point de vu légal, de tout incident qui pourrait survenir.

    En tant que sous-traitant, BNP Paribas traite les données à caractère personnel conformément aux Conditions de Traitement des Données à Caractère Personnel (CTDCP), annexées à tous les contrats.

    Ainsi :

    • Les données personnelles prévues par le CTDCP doivent uniquement être transmises à BNP Paribas au travers des champs prévus à cet effet (cf. dictionnaire des données).
    • Toutes autres données à caractère personnel non listées dans le CTDCP ne doivent pas être transmises à BNP Paribas
  • paymentMeanBrand
    présence
    Optionnel
    Interface version
    4
    Ordre
    20

    Nom du moyen de paiement utilisé. Il est lié à un paymentMeanType.

    Liste des valeurs
    1EUROCOM
    Cofidis Pay 5x10x20x Contrat d’acquisition : ONLINE_CREDIT
    3XCBCOFINOGA
    Valeur Obsolète. Cofinoga 3xCB paymentMeanBrandType : CARD
    ACCEPTGIRO
    AcceptGiro paymentMeanBrandType : CREDIT_TRANSFER
    AIRPLUS
    Carte Airplus paymentMeanBrandType : CARD
    AIRPLUS_LOGEE
    Carte Airplus logée paymentMeanBrandType : CARD
    AMEX
    Carte American Express paymentMeanBrandType : CARD
    AMEX_LOGEE
    Carte American Express logée paymentMeanBrandType : CARD
    AURORE
    Carte CPAY paymentMeanBrandType : CARD
    BCACB_3X
    Floa Bank CB paiement en 3 fois paymentMeanBrandType : ONLINE_CREDIT
    BCACB_4X
    Floa Bank CB paiement en 4 fois paymentMeanBrandType : ONLINE_CREDIT
    BCACUP
    Carte CUP de Floa Bank paymentMeanBrandType : CARD
    BCMC
    Bancontact paymentMeanBrandType : CARD
    CACF_3X
    CACF paiement en 3 fois paymentMeanBrandType : ONLINE_CREDIT
    CACF_3XSANSFRAIS
    CACF paiement en 3 fois sans frais paymentMeanBrandType : ONLINE_CREDIT
    CACF_4X
    CACF paiement en 4 fois paymentMeanBrandType : ONLINE_CREDIT
    CACF_4XSANSFRAIS
    CACF paiement en 4 fois sans frais paymentMeanBrandType : ONLINE_CREDIT
    CADHOC
    Cadhoc paymentMeanBrandType : CARD
    CADOCARTE
    Cado Carte paymentMeanBrandType : CARD
    CB
    Carte Bancaire paymentMeanBrandType : CARD
    CETELEM_3X
    Cetelem 3xCB paymentMeanBrandType : ONLINE_CREDIT
    CETELEM_4X
    Cetelem 4xCB paymentMeanBrandType : ONLINE_CREDIT
    COFIDIS_3X
    Cofidis 3xCB paymentMeanBrandType : ONLINE_CREDIT
    COFIDIS_4X
    Cofidis 4xCB paymentMeanBrandType : ONLINE_CREDIT
    CONECS
    Titres Restaurants Dématérialisés Conecs paymentMeanBrandType : VOUCHER
    CUP
    Carte China UnionPay paymentMeanBrandType : CARD
    CVA
    Carte Visa Aurore paymentMeanBrandType : CARD
    CVCO
    Chèque-Vacances Connect paymentMeanBrandType : VOUCHER
    DINERS
    Carte Diners club international paymentMeanBrandType : CARD
    FRANFINANCE_3X
    Franfinance 3xCB paymentMeanBrandType : ONLINE_CREDIT
    FRANFINANCE_4X
    Franfinance 4xCB paymentMeanBrandType : ONLINE_CREDIT
    GIROPAY
    Giropay paymentMeanBrandType : CREDIT_TRANSFER
    ILLICADO
    Illicado paymentMeanBrandType : CARD
    INCASSO
    Incasso paymentMeanBrandType : DIRECT_DEBIT
    INGHOMEPAY
    PayButton ING Home’Pay paymentMeanBrandType : CREDIT_TRANSFER
    JCB
    Carte Japan Credit Bureau paymentMeanBrandType : CARD
    LEPOTCOMMUN
    Le Pot Commun paymentMeanBrandType : CARD
    LYDIA
    Lydia paymentMeanBrandType : PROVIDER
    MAESTRO
    Carte Maestro (Mastercard) paymentMeanBrandType : CARD
    MASTERCARD
    Carte Mastercard paymentMeanBrandType : CARD
    MASTERPASS
    Obsolète - Portefeuille virtuel MasterPass paymentMeanBrandType :
    ONEY34X
    Oney Paiement 3 fois ou 4 fois paymentMeanBrandType : ONLINE_CREDIT
    PAYLIB
    Portefeuille virtuel Paylib paymentMeanBrandType :
    PAYPAL
    Paypal paymentMeanBrandType : WALLET
    PAYTRAIL
    Paytrail paymentMeanBrandType : CREDIT_TRANSFER
    PAY_BY_BANK
    Virement bancaire SEPA paymentMeanBrandType : CREDIT_TRANSFER
    SEPA_DIRECT_DEBIT
    SDD (SEPA Direct Debit) paymentMeanBrandType : DIRECT_DEBIT
    SOFINCO
    Carte Sofinco paymentMeanBrandType : CARD
    SOFORTUBERWEISUNG
    Sofortüberweisung (Sofort Banking) paymentMeanBrandType : CREDIT_TRANSFER
    UNKNOWN
    Moyen de paiement inconnu (cette valeur peut être retournée par Mercanet mais ne doit pas être utilisée dans une requête)
    VISA
    Carte Visa paymentMeanBrandType : CARD
    VISACHECKOUT
    Obsolète - Portefeuille virtuel Visa Checkout paymentMeanBrandType : WALLET
    VISA_ELECTRON
    Carte Visa Electron paymentMeanBrandType : CARD
    VPAY
    Carte VPAY (Visa) paymentMeanBrandType : CARD
  • responseCode
    présence
    Optionnel
    Interface version
    4
    Ordre
    16

    Code réponse du serveur Mercanet.

    Liste des valeurs
    00
    Opération acceptée
    01
    Pour les méthodes panToToken et tokenToPan, succès partiel
    02
    Demande d’autorisation par téléphone à la banque à cause d’un dépassement du plafond d’autorisation sur la carte
    03
    Contrat commerçant invalide
    05
    Autorisation refusée
    11
    Utilisé dans le cas d’un contrôle différé. Le PAN est en opposition
    12
    Transaction invalide, vérifier les paramètres transférés dans la requête
    14
    Coordonnées du moyen de paiement invalides (ex : n° de carte ou cryptogramme visuel de la carte) ou vérification AVS échouée
    17
    Annulation de l’acheteur
    24
    • En réponse d’une opération de gestion de caisse : opération impossible. L’opération que vous souhaitez réaliser n’est pas compatible avec l’état de la transaction ou une autre opération de caisse est en cours sur la transaction au même moment.
    • En réponse d’une création de paiement : opération rejetée, requête déjà effectuée avec les mêmes données et les mêmes paramètres
    25
    Transaction inconnue de Mercanet
    30
    Erreur de format
    34
    Suspicion de fraude (seal erroné)
    40
    Fonction non supportée : l’opération que vous souhaitez réaliser ne fait pas partie de la liste des opérations auxquelles vous êtes autorisés
    51
    Montant trop élevé
    54
    Date de validité du moyen de paiement dépassée
    55
    Cartes prépayées non acceptées
    57
    Remboursement refusé car la transaction d’origine a fait l’objet d’un impayé
    60
    Transaction en attente
    62
    En attente de confirmation pour la transaction (utilisé par PayPal 1.0)
    63
    Règles de sécurité non respectées, transaction arrêtée
    75
    Nombre de tentatives de saisie des coordonnées du moyen de paiement sous Paypage dépassé
    90
    Service temporairement indisponible
    94
    Transaction dupliquée : le transactionReference de la transaction est déjà utilisé
    97
    Session expirée (aucune action de l’utilisateur pendant 15 minutes), transaction refusée
    99
    Problème temporaire du serveur de paiement.
  • returnContext
    présence
    Optionnel
    Interface version
    4
    Ordre
    13

    Contexte de la commande d’un acheteur.Toute information transmise dans ce champ par le commerçant lors de la requête de paiement est renvoyée dans la réponse sans modification.Attention : les caractères suivants “|”, “«”, “»”, et «”» sont à éviter dans ce champ. Si ces caractères sont utilisés, ils vous seront renvoyés tels quels, mais seront remplacés par des blancs dans les bases de données Mercanet.

    Attention : utiliser ce champ libre uniquement pour l’usage prévu, et par conséquent ne pas y insérer des données à caractère personnel, et plus particulièrement des données de porteur de carte. En cas de non-respect de cette consigne BNP Paribas ne serait être tenu responsable d’un point de vu légal, de tout incident qui pourrait survenir.

    En tant que sous-traitant, BNP Paribas traite les données à caractère personnel conformément aux Conditions de Traitement des Données à Caractère Personnel (CTDCP), annexées à tous les contrats.

    Ainsi :

    • Les données personnelles prévues par le CTDCP doivent uniquement être transmises à BNP Paribas au travers des champs prévus à cet effet (cf. dictionnaire des données).
    • Toutes autres données à caractère personnel non listées dans le CTDCP ne doivent pas être transmises à BNP Paribas
  • s10TransactionReference
    présence
    Optionnel
    Interface version
    4
    Ordre
    15

    Contient les informations sur l’identification de la transaction, compatible avec Mercanet 1.0.Contient le s10TransactionId / s10TransactionIdDate qui assure l’unicité de la transaction 1.0.

    Contient
  • statementReference
    présence
    Optionnel
    Interface version XML
    10
    Interface version CSV
    10
    Ordre
    25

    Référence fournie par le commerçant qui est envoyée dans le flux de remise en paiement. Cette référence apparait sur les relevés de compte du porteur.A noter que pour les paiements CB, Visa et Mastercard via un acquéreur français, seuls les 32 premiers caractères de ce champ sont conservés et apparaissent sur le relevé de compte du porteur.

  • transactionOrigin
    présence
    Optionnel
    Interface version
    4
    Ordre
    14

    Origine d’une transaction (ex : nom du programme), valorisée par le commerçant. Exemple : “site Web A v1.32”.

  • transactionPlatform
    présence
    Optionnel
    Interface version XML
    7
    Interface version CSV
    7
    Ordre
    24

    Plate-forme d’exécution de la transaction.

    Liste des valeurs
    PRE-PROD
    Pre-production transaction not sent to remittance
    PROD
    Production transaction
    SIMU
    Simulated transaction
    UAT
    User acceptance test transaction
  • transactionReference
    présence
    Optionnel
    Interface version
    4
    Ordre
    3

    Le commerçant a le choix d’identifier ses transactions par un transactionReference (mode par défaut) ou par un transactionId. transactionReference identifie de manière unique une transaction tout au long de la vie de la boutique.

  • virtualCardIndicator
    présence
    Optionnel
    Interface version XML
    13
    Interface version CSV
    13
    Ordre
    26

    Indique si la carte est une carte virtuelle

    Liste des valeurs
    Empty
    Inconnu
    N
    La carte n’est pas une carte virtuelle
    Y
    La carte est une carte virtuelle

Exemple de réponse

            FILE;response;office;v19
HEADER;023101122334455;2021-12-16+0100;14:26:45+0100;1;00;2021-12-16T00:00:00+0100;2021-12-16T00:00:00+0100
WALLETCREDIT;12;023101122334456;SIM20220329092501;66;w01;paymentMeanId;978;customer@email.com;customerId;128.0.0.1;INTERNET;orderId;returnContext;origin;101;20210329;00;00;authorisationId;maskedPan;VISA;TO_CAPTURE;operationDateTime;00;transactionPlatform;statementReference;virtualCardIndicator
END;1

        
            <?xml version="1.0" encoding="UTF-8"?>
<file version="v19" format="office" type="response">
    <header>
        <remitterId>023101122334455</remitterId>
        <date>2021-12-16+01:00</date>
        <time>14:26:45+01:00</time>
        <sequence>1</sequence>
        <processingResponseCode>00</processingResponseCode>
        <beginProcessTime>2021-12-16T00:00:00+01:00</beginProcessTime>
        <endProcessTime>2021-12-16T00:00:00+01:00</endProcessTime>
    </header>
	<body>
		<walletCredit recordSequence="1">
            <merchantId>023101122334456</merchantId>
            <transactionReference>SIM20220329092501</transactionReference>
            <amount>66</amount>
            <merchantWalletId>w01</merchantWalletId>
            <paymentMeanId>paymentMeanId</paymentMeanId>
            <currencyCode>978</currencyCode>
            <customerEmail>customer@email.com</customerEmail>
            <customerId>customerId</customerId>
            <customerIpAddress>128.0.0.1</customerIpAddress>
            <orderChannel>INTERNET</orderChannel>
            <orderId>orderId</orderId>
            <returnContext>returnContext</returnContext>
            <transactionOrigin>origin</transactionOrigin>
            <s10TransactionReference>
                <s10TransactionId>101</s10TransactionId>
                <s10TransactionIdDate>20210329</s10TransactionIdDate>
            </s10TransactionReference>
            <responseCode>00</responseCode>
            <authorisationId>authorisationId</authorisationId>
            <maskedPan>maskedPan</maskedPan>
            <paymentMeanBrand>VISA</paymentMeanBrand>
            <newStatus>TO_CAPTURE</newStatus>
            <operationDateTime>operationDateTime</operationDateTime>
            <officeBatchResponseCode>00</officeBatchResponseCode>
            <transactionPlatform>transactionPlatform</transactionPlatform>
            <statementReference>statementReference</statementReference>
            <virtualCardIndicator>virtualCardIndicator</virtualCardIndicator>
            <acquirerResponseCode>00</acquirerResponseCode>
        </walletCredit>
	</body>
	<end nbRecord="1" />
</file>

        

Changelog


Interface version Donnée Présence Conteneur
4 amount Requête/Réponse
4 currencyCode Requête/Réponse
4 merchantId Requête/Réponse
4 merchantWalletId Requête/Réponse
4 paymentMeanId Requête/Réponse
4 recordSequence Requête/Réponse
4 customerEmail Requête/Réponse
4 customerId Requête/Réponse
4 customerIpAddress Requête/Réponse
XML: 20
CSV: 20
merchantLocationId Requête
4 orderChannel Requête/Réponse
4 orderId Requête/Réponse
4 returnContext Requête/Réponse
4 s10TransactionReference Requête/Réponse
4 s10TransactionId Conteneur
  • s10TransactionReference
  • 4 s10TransactionIdDate Conteneur
  • s10TransactionReference
  • XML: 13
    CSV: 13
    settlementArchivingReference Requête
    XML: 13
    CSV: 13
    settlementMerchantSpecificData Requête
    XML: 10
    CSV: 10
    statementReference Requête/Réponse
    4 transactionOrigin Requête/Réponse
    4 transactionReference Requête/Réponse
    4 officeBatchResponseCode Réponse
    4 acquirerResponseCode Réponse
    4 authorisationId Réponse
    4 maskedPan Réponse
    4 newStatus Réponse
    4 operationDateTime Réponse
    4 paymentMeanBrand Réponse
    4 responseCode Réponse
    XML: 7
    CSV: 7
    transactionPlatform Réponse
    XML: 13
    CSV: 13
    virtualCardIndicator Réponse
    Retourner en haut de page Besoin d'aide ?

    Besoin d'aide ?

    Fermer