creditTransferInquire

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

Cette opération permet de récupérer la liste des banques émettrices disponibles. Actuellement, ce service n’est disponible que pour le moyen de paiement iDEAL.

Cette requête permet d’obtenir une liste des banques émettrices. Si la requête a réussi, vous recevez en retour une liste de banques avec leur nom et leur code. Ces informations doivent être utilisées pour l’étape d’initialisation (creditTransferInitialize).

interfaceVersion recommandée : IR_WS_2.55

PROD

https://office-server.mercanet.com/rs-services/v2/checkout/creditTransferInquire

méthode

POST
TEST

https://office-server-mercanet.test.sips-services.com/rs-services/v2/checkout/creditTransferInquire

méthode

POST

PROD

https://office-server.mercanet.com/services/v2/checkout?wsdl

méthode

POST
TEST

https://office-server-mercanet.test.sips-services.com/services/v2/checkout?wsdl

méthode

POST

Requête

Obligatoire

currencyCode

présence

Obligatoire

Interface version

2.0

Format

N3(restricted values / ISO4217)

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
interfaceVersion
présence

Obligatoire

Interface version

2.0
Format
AN20(restricted String)
Version de l’interface utilisée. Elle est composée d’un préfixe qui varie selon la fonction utilisée et d’un numéro de version (ex : IR_WS_2.47).

Veuillez-vous référer à la page de la fonction pour connaître la valeur à utiliser. Utilisez le dernier numéro d’interfaceVersion.

Liste des valeurs

IR_WS_

interface Paypage et Office (M2M) (SOAP/JSON).
keyVersion

présence

Obligatoire

Interface version

2.0

Format

N10

Version de la clé secrète du commerçant utilisée pour calculer l’empreinte du message (clé stockée par le commerçant pour vérifier l’empreinte des notifications automatiques et manuelles).
merchantId

présence

Obligatoire

Interface version

2.0

Format

N15

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

présence

Obligatoire

Interface version

2.0

Format

ANS20(restricted values)

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

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
seal

présence

Obligatoire

Interface version

2.0

Format

ANS128

Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).

Optionnel

customerLanguage

présence

Optionnel

Interface version

2.0

Format

A2(restricted values)

Langage de l’utilisateur, utilisé dans les pages de paiement.

Liste des valeurs

It

Italien

Ja

Japonais

cs

Tchèque

da

Danois

de

Allemand

el

Grec

en

Anglais

es

Espagnol

et

Estonien

fi

Finnois

fr

Français

hu

Hongrois

ko

Coréen

lt

Lituanien

lv

Letton

nl

Néerlandais

no

Norvégien

pl

Polonais

pt

Portugais

ro

Roumain

ru

Russe

sk

Slovaque

sl

Slovène

sv

Suédois

tr

Turc

uk

Ukrainien

zh

Chinois
intermediateServiceProviderId

présence

Optionnel

Interface version

2.12

Format

AN30

Identifiant du service utilisé par le commerçant pour les échanges de flux avec la plateforme Mercanet.
s10TransactionReference

présence

Optionnel

Interface version

2.0

Format

Container

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
- s10TransactionId
  
  présence
  
  Optionnel
  
  Interface version
  
  2.0
  
  Format
  
  N6
  
  Le commerçant a le choix d’identifier ses transactions par un transactionId ou par un transactionReference (mode par défaut). s10TransactionId est un identifiant alternatif de la transaction compatible avec Mercanet 1.0. Il identifie une transaction de manière unique sur une journée. Le couple s10TransactionId/s10TransactionIdDate assure l’unicité de la transaction.
- s10TransactionIdDate
  
  présence
  
  Optionnel
  
  Interface version
  
  2.0
  
  Format
  
  N8(YYYYMMDD)
  
  Date de la transaction (exprimée dans le time zone du serveur Mercanet).Le couple s10TransactionId/s10TransactionIdDate assure l’unicité de la transaction 1.0.L’utilisation de ce couple en lieu et place de la donnée transactionReference dépend de la configuration du commerçant.
sealAlgorithm

présence

Optionnel

Interface version

2.12

Format

ANS20(restricted values)

Algorithme de cryptage utilisé pour le calcul du sceau.

Liste des valeurs

HMAC-SHA-256

L’algorithme de cryptage utilisé est HMAC-SHA-256

HMAC-SHA-512

L’algorithme de cryptage utilisé est HMAC-SHA-512

SHA-256

L’algorithme de cryptage utilisé est SHA-256
transactionReference

présence

Optionnel

Interface version

2.0

Format

AN35

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

json
soap

            {
  "currencyCode": "978",
  "customerLanguage": "fr",
  "interfaceVersion": "IR_WS_2.9",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "paymentMeanBrand": "IDEAL",
  "transactionReference": " TREFEXA2015",
  "seal": "ec7be3e2a0086a86f66f74bb6e10f244e51e4e648c7dbbf7c89ce9aa78a569cf"
}

                  <urn:creditTransferInquire>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:transactionReference>TREFEXA2015</urn:transactionReference>
            <urn:interfaceVersion>IR_WS_2.6</urn:interfaceVersion>
            <urn:currencyCode>978</urn:currencyCode>
            <urn:customerLanguage>fr</urn:customerLanguage>
            <urn:paymentMeanBrand>IDEAL</urn:paymentMeanBrand>
         </urn:input>
      </urn:creditTransferInquire>

Réponse

Obligatoire

responseCode

présence

Obligatoire

Interface version

2.0

Format

N2(restricted values)

Code réponse du serveur Mercanet.

Liste des valeurs

00

Opération acceptée

03

Contrat commerçant invalide

12

Transaction invalide, vérifier les paramètres transférés dans la requête

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

99

Problème temporaire du serveur de paiement.
seal

présence

Obligatoire

Interface version

2.0

Format

ANS128

Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).

Optionnel

customerBankList

présence

Optionnel

Interface version

2.0

Format

composite list

liste des banques du client
Contient
- customerBankCode
  
  présence
  
  Optionnel
  
  Interface version
  
  2.0
  
  Format
  
  AN11
  
  Code banque du client dont la codification peut varier selon la donnée customerBankAccountType : formats nationaux, internationaux ou autres formats spécifiques (ex : BIC).
- customerBankName
  
  présence
  
  Optionnel
  
  Interface version
  
  2.0
  
  Format
  
  ANS150
  
  Nom de la banque du client.
errorFieldName

présence

Optionnel

Interface version

2.0

Format

ANS50

Nom du champ en erreur dans la requête. Présent lorsque responseCode = 12 ou 30.

Exemple de réponse

json
soap

            {
  "customerBankList": [
    {
      "customerBankCode": "RABONL2U",
      "customerBankName": "BANK - RABO"
    },
    {
      "customerBankCode": "INGBNL2A",
      "customerBankName": "BANK - ING"
    }
  ],
  "responseCode": "00",
  "seal": "c46465d780517ce593b4bd5afe789fe58d2bc972937aaa35707ec8668265e6dc"
}

                  <creditTransferInquireResponse xmlns="urn:sips:cn:contract:office:checkout:v2">
         <output>
            <responseCode>00</responseCode>
            <customerBankList>
               <customerBankCode>RABONL2U</customerBankCode>
               <customerBankName>BANK - RABO</customerBankName>
            </customerBankList>
         </output>
      </creditTransferInquireResponse>

Changelog

Filtre

Interface version	Donnée	Présence	Conteneur
2.0	`customerLanguage`	Requête
2.12	`intermediateServiceProviderId`	Requête
2.0	`s10TransactionReference`	Requête
2.0	`s10TransactionId`	Conteneur	`s10TransactionReference`
2.0	`s10TransactionIdDate`	Conteneur	`s10TransactionReference`
2.12	`sealAlgorithm`	Requête
2.0	`transactionReference`	Requête
2.0	`currencyCode`	Requête
2.0	`interfaceVersion`	Requête
2.0	`keyVersion`	Requête
2.0	`merchantId`	Requête
2.0	`paymentMeanBrand`	Requête
2.0	`seal`	Requête/Réponse
2.0	`customerBankList`	Réponse
2.0	`customerBankCode`	Conteneur	`customerBankList`
2.0	`customerBankName`	Conteneur	`customerBankList`
2.0	`errorFieldName`	Réponse
2.0	`responseCode`	Réponse