Release 24.5

aller directement au contenu

Rechercher par mots clés

creditTransferInitialize

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

Cette opération est actuellement disponible pour les moyens de paiement iDEAL et Sofortüberweisung.

Cette requête initialise une session pour un virement bancaire. Si l’étape d’initialisation a réussi, vous recevez en retour une URL sécurisée (redirectionUrl) vers laquelle le client doit être redirigé pour poursuivre le virement. Cette redirection doit être réalisée par le biais d’un formulaire POST, voir la partie “Formulaire POST vers des fournisseurs externes”.

Dans la requête, vous devez également indiquer l’URL (merchantReturnUrl) vers laquelle le client sera redirigé à la fin du virement bancaire externe. Vous devez ensuite appeler le service creditTransferFinalizeAndOrder afin de finaliser la transaction.

interfaceVersion recommandée : IR_WS_2.55

  • PROD
    https://sherlocks-office-server.secure.lcl.fr/rs-services/v2/checkout/creditTransferInitialize
    méthode
    POST
  • TEST
    https://office-server-sherlocks.test.sips-services.com/rs-services/v2/checkout/creditTransferInitialize
    méthode
    POST
  • PROD
    https://sherlocks-office-server.secure.lcl.fr/services/v2/checkout?wsdl
    méthode
    POST
  • TEST
    https://office-server-sherlocks.test.sips-services.com/services/v2/checkout?wsdl
    méthode
    POST

Obligatoire

  • amount
    présence
    Obligatoire
    Interface version
    2.0

    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
    2.0

    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

    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 Sherlock’s Paypage et Sherlock’s Office (SOAP/JSON).
  • keyVersion
    présence
    Obligatoire
    Interface version
    2.0

    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

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

  • orderChannel
    présence
    Obligatoire
    Interface version
    2.0

    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
  • paymentMeanBrand
    présence
    Obligatoire
    Interface version
    2.0

    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 Sherlock’s 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

    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).

Conditionnel

Optionnel

Exemple de requête

            {
  "amount": "1000",
  "currencyCode": "978",
  "customerBankCode": "RABONL2U",
  "customerBankName": "BANK - RABO",
  "customerLanguage": "fr",
  "interfaceVersion": "IR_WS_2.9",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "merchantReturnUrl": "http://www.yoursiteweb.com",
  "merchantTransactionDateTime": "2015-05-28T11:07:11.005+02:00",
  "orderChannel": "INTERNET",
  "orderId": "123",
  "paymentMeanBrand": "IDEAL",
  "transactionReference": " TREFEXA2015",
  "seal": "50e15601a2e83bcc5ffe596a51bab5b8dab2e3c62d3de2fe0d15502600f4aded"
}

        
                  <urn:creditTransferInitialize>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:transactionReference>TREFEXA2015</urn:transactionReference>
            <urn:interfaceVersion>IR_WS_2.9</urn:interfaceVersion>
            <urn:amount>2500</urn:amount> 
            <urn:customerBankCode>RABONL2U</urn:customerBankCode>            
            <urn:customerBankName>BANK - RABO</urn:customerBankName>
            <urn:currencyCode>978</urn:currencyCode>
            <urn:customerId>cust01</urn:customerId>
            <urn:customerIpAddress>127.0.0.1</urn:customerIpAddress>
            <urn:customerLanguage>fr</urn:customerLanguage>
            <urn:orderChannel>INTERNET</urn:orderChannel>
            <urn:orderId>123456</urn:orderId>
            <urn:paymentMeanBrand>IDEAL</urn:paymentMeanBrand>
            <urn:merchantReturnUrl>http://www.yoursiteweb.com</urn:merchantReturnUrl>
         </urn:input>
      </urn:creditTransferInitialize>

Obligatoire

  • seal
    présence
    Obligatoire
    Interface version
    2.0

    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

Exemple de réponse

            {
  "responseCode": "00",
  "redirectionUrl": "https://payment-web.test.sips-services.com/paymentprovider/init",
  "redirectionData": "RSs7cZyL1D...a+hZ+1ticHD/4/s\u003d",
  "messageVersion": "0.1",
  "seal": "d0814427cbd5515e78cb54476c8594eb2c1d3732a9b392afd325ebae33945069"
}

        
                  <creditTransferInitializeResponse xmlns="urn:sips:cn:contract:office:checkout:v2">
         <output>
            <responseCode>00</responseCode>
            <redirectionUrl>https://payment-web.test.sips-services.com/paymentprovider/init</redirectionUrl>
            <redirectionData>RSs7cZyL1DqsVs...vceJKsC4lg</redirectionData>
            <messageVersion>0.1</messageVersion>
         </output>
      </creditTransferInitializeResponse>

Changelog


Interface version Donnée Présence Conteneur
2.0 billingAddress Requête
2.0 addressAdditional3 Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 addressAdditional1 Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 addressAdditional2 Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 city Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 company Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 country Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 postBox Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 state Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 street Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 streetNumber Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 zipCode Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 billingContact Requête
    2.0 email Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 firstname Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 gender Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.11 initials Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 lastname Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 mobile Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 phone Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 title Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.23 workphone Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 customerAddress Requête
    2.0 customerContact Requête
    2.0 customerData Requête
    2.0 birthCity Conteneur
  • customerData
    • 2.0 birthCountry Conteneur
  • customerData
    • 2.0 birthZipCode Conteneur
  • customerData
    • 2.0 birthDate Conteneur
  • customerData
    • 2.51 loyaltyIndicator Conteneur
  • customerData
    • 2.18 maidenName Conteneur
  • customerData
    • 2.0 nationalityCountry Conteneur
  • customerData
    • 2.0 newPassword Conteneur
  • customerData
    • 2.0 password Conteneur
  • customerData
    • 2.0 customerId Requête
    2.0 customerIpAddress Requête
    2.0 customerLanguage Requête
    2.0 deliveryAddress Requête
    2.0 deliveryContact Requête
    2.10 fraudData Requête
    2.10 allowedIpCountryList Conteneur
  • fraudData
    • 2.10 deniedIpCountryList Conteneur
  • fraudData
    • 2.10 bypass3DS Conteneur
  • fraudData
    • 2.10 bypassCtrlList Conteneur
  • fraudData
    • 2.10 allowedCardArea Conteneur
  • fraudData
    • 2.10 allowedIpArea Conteneur
  • fraudData
    • 2.10 deniedCardArea Conteneur
  • fraudData
    • 2.10 deniedCardCountryList Conteneur
  • fraudData
    • 2.23 challengeMode3DS Conteneur
  • fraudData
    • 2.10 allowedCardCountryList Conteneur
  • fraudData
    • 2.23 addressDeliveryBillingMatchIndicator Conteneur
  • fraudData
    • 2.10 deniedIpArea Conteneur
  • fraudData
    • 2.10 bypassInfoList Conteneur
  • fraudData
    • 2.39 merchantAuthentScoreValue Conteneur
  • fraudData
    • 2.27 merchantCustomerAuthentData Conteneur
  • fraudData
    • 2.27 merchantCustomerAuthentDateTime Conteneur
  • fraudData
    • 2.23 merchantCustomerAuthentMethod Conteneur
  • fraudData
    • 2.23 nameDeliveryCustomerMatchIndicator Conteneur
  • fraudData
    • 2.27 productAvailabilityDate Conteneur
  • fraudData
    • 2.23 productAvailabilityIndicator Conteneur
  • fraudData
    • 2.23 reorderProductIndicator Conteneur
  • fraudData
    • 2.10 riskManagementDynamicSettingList Conteneur
  • fraudData
    • 2.10 riskManagementDynamicSetting Conteneur
  • riskManagementDynamicSettingList
    • 2.10 riskManagementDynamicParam Conteneur
  • riskManagementDynamicSetting
    • 2.10 riskManagementDynamicValue Conteneur
  • riskManagementDynamicSetting
    • 2.0 holderAddress Requête
    2.0 holderContact Requête
    2.12 intermediateServiceProviderId Requête
    2.0 invoiceReference Requête
    2.0 merchantReturnUrl Requête
    2.0 merchantTransactionDateTime Requête
    2.0 orderId Requête
    2.0 paymentPattern Requête
    2.0 returnContext Requête
    2.0 s10TransactionReference Requête
    2.0 s10TransactionId Conteneur
  • s10TransactionReference
    • 2.0 s10TransactionIdDate Conteneur
  • s10TransactionReference
    • 2.12 sealAlgorithm Requête
    2.33 settlementArchivingReference Requête
    2.33 settlementMerchantSpecificData Requête
    2.0 statementReference Requête
    2.0 transactionOrigin Requête
    2.0 transactionReference Requête
    2.0 amount Requête
    2.0 currencyCode Requête
    2.0 interfaceVersion Requête
    2.0 keyVersion Requête
    2.0 merchantId Requête
    2.0 orderChannel Requête
    2.0 paymentMeanBrand Requête
    2.0 seal Requête/Réponse
    2.0 customerBankCode Requête
    2.0 customerBankName Requête
    2.0 errorFieldName Réponse
    2.0 messageVersion Réponse
    2.0 redirectionData Réponse
    2.0 redirectionUrl Réponse
    2.0 responseCode Réponse
    Retourner en haut de page Besoin d'aide ?

    Besoin d'aide ?

    Contacter le support
    Fermer

    Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation Sherlock's.
    En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

    Paramètres