WL SIPS DOCS

Release 23.2

aller directement au contenu

Rechercher par mots clés

walletCheckEnrollment

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

Cette opération permet d’initialiser un paiement par wallet avec le processus 3-D Secure.

Cette requête initialise une transaction sur la plateforme Worldline Sips et vérifie si la carte récupérée à partir du wallet est inscrite au programme 3-D Secure. Si la carte est inscrite à 3-D Secure, vous recevez comme réponse une URL sécurisée (redirectionUrl) vers laquelle le client doit être redirigé pour poursuivre son authentification. Cette redirection doit être réalisée par le biais d’un formulaire POST, voir la partie “Formulaire POST vers l’ACS”. Dans le cas contraire, vous avez la possibilité de poursuivre le paiement sans effectuer de redirection en appelant directement la méthode cardValidateAuthenticationAndOrder.

interfaceVersion recommandée : IR_WS_2.48

  • PROD
    https://office-server.sips-services.com/rs-services/v2/checkout/walletCheckEnrollment
    méthode
    POST
  • TEST
    https://office-server.test.sips-services.com/rs-services/v2/checkout/walletCheckEnrollment
    méthode
    POST
  • PROD
    https://office-server.sips-services.com/services/v2/checkout?wsdl
    méthode
    POST
  • TEST
    https://office-server.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
    AUT_WS_2.
    interface Sips Office (SOAP/JSON) pour les services d’authentification Worldline Sips
    CR_WS_2.
    interface Sips Office (SOAP/JSON) pour les fonctions de gestion de caisse.
    DR_WS_2.
    interface Sips Office (SOAP/JSON) pour les fonctions de diagnostique.
    FR_WS_2.
    interface Sips Office (SOAP) interface pour les fonctions de fraude.
    HP_x.x
    interface Sips Paypage et Sips Walletpage (POST).
    IR_MB_
    interface Sips In-App (JSON) pour les fonctions Sips In-App.
    IR_WS_
    interface Sips Paypage et Sips Office (SOAP/JSON).
    MR_WS_2.
    interface Sips Office (SOAP/JSON) pour les fonctions liées aux mandats.
    PMR_WS_2.
    interface Sips Office (SOAP/JSON) pour les fonctions de demande d’information sur le référentiel des moyens de paiement.
    TR_WS_2.
    interface Sips Office (SOAP) pour les fonctions de token.
    WMR_WS_2.
    interface Sips Walletpage(SOAP/JSON).
    WR_WS_2.
    interface Sips Office (SOAP/JSON) pour les fonctions liées au wallet.
  • 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 Worldline Sips au commerçant lors de l’inscription de sa boutique.

  • merchantWalletId
    présence
    Obligatoire
    Interface version
    2.0

    Identifiant du portefeuille virtuel du client.

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

    Rang du moyen de paiement au sein du wallet Worldline Sips.

  • 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 requête

            {
  "amount": "1000",
  "captureDay": "0",
  "captureMode": "AUTHOR_CAPTURE",
  "cardCSCValue": "123",
  "currencyCode": "978",
  "interfaceVersion": "IR_WS_2.9",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "merchantTransactionDateTime": "2015-05-28T11:30:14.232+02:00",
  "merchantWalletId": "WALLET01",
  "orderChannel": "INTERNET",
  "orderId": "1234",
  "paymentMeanId": "10",
  "transactionReference": "TREFEXA2015",
  "seal": "3bfc4e958ba4ea43090db3c0c0bdba7162c92727ca1338b2111b28ddd91056a1"
}

        
                  <urn:walletCheckEnrollment>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:transactionReference>TREFEXA2015</urn:transactionReference>
            <urn:interfaceVersion>IR_WS_2.9</urn:interfaceVersion>
            <urn:amount>1000</urn:amount>
            <urn:captureDay>0</urn:captureDay>
            <urn:captureMode>AUTHOR_CAPTURE</urn:captureMode>
            <urn:cardCSCValue>123</urn:cardCSCValue>
            <urn:currencyCode>978</urn:currencyCode>
            <urn:merchantTransactionDateTime>2015-04-27T19:21:22.405+02:00</urn:merchantTransactionDateTime>
            <urn:merchantWalletId>WALLET01</urn:merchantWalletId>
            <urn:orderChannel>INTERNET</urn:orderChannel>
            <urn:orderId>123456</urn:orderId>
            <paymentMeanId>10</paymentMeanId>
         </urn:input>
      </urn:walletCheckEnrollment>

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

  • errorFieldName
    présence
    Optionnel
    Interface version
    2.0

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

  • messageVersion
    présence
    Optionnel
    Interface version
    2.0

    Version des paramètres de redirection.

  • paReqMessage
    présence
    Optionnel
    Interface version
    2.0

    Payer Authentication Request (PAReq) que le commerçant doit transmettre à l’ACS lors de l’authentification 3-D Secure.

  • redirectionData
    présence
    Optionnel
    Interface version
    2.0

    Dans le cas d’un paiement 3-D Secure, contient le contexte de la transaction récupéré en sortie de la méthode cardCheckEnrolment. Dans le cas de 3-D Secure Server Standalone, Message PARes que le commerçant doit transmettre à l’ACS (Access Control Server) pour l’authentification 3-D Secure du porteur (format : encodage base 64).Dans le cas d’un paiement via un partenaire externe, contient le contexte de la transaction envoyée par le commerçant pendant l’initialisation de la transaction.

  • redirectionStatusCode
    présence
    Optionnel
    Interface version
    2.0

    Code réponse retourné par Worldline Sips lors d’une redirection (exemple : redirection vers l’ACS, redirection vers le serveur Worldline Sips). Indique si la redirection est possible ou non.

    Liste des valeurs
    00
    • En retour de paymentWebInit : transaction initialisée
    • En retour de walletCheckEnrollment et cardCheckEnrollment : Carte enrôlée
    01
    En retour de cardCheckEnrollment et walletCheckEnrollment : carte non enrôlée 3-D Secure
    03
    Contrat commerçant invalide
    10
    Enrôlement de la carte n’a pas pu être défini (uniquement en réponse de cardCheckEnrollment et walletCheckEnrollment)
    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)
    30
    Erreur de format (Webinit ERROR)
    34
    Suspicion de fraude, erreur signature (Webinit ERROR)
    80
    Erreur rencontrée lors de l’interrogation du DS
    89
    Session du serveur 3-D Secure expirée
    91
    Commerçant non configuré dans le serveur 3-D Secure
    94
    • En réponse de paymentWebInit : transaction dupliquée. Le transactionReference de la transaction a déjà été utilisé
    • En réponse de cardCheckEnrollment ou walletCheckEnrollment : erreur pendant la vérification de l’enrôlement
    99
    Erreur interne
  • redirectionUrl
    présence
    Optionnel
    Interface version
    2.0

    Dans le cas d’une vérification d’enrôlement, contient l’URL de redirection vers l’ACS requis pour l’authentification du porteur. Dans le cas d’un paiement in-App, contient l’URL du prochain appel.Dans le cas de 3-D Secure standalone, contient l’URL de redirection vers l’ACS requis pour l’authentification du porteur.

  • responseCode
    présence
    Optionnel
    Interface version
    2.23

    Code réponse du serveur Worldline Sips.

    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 Worldline Sips
    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 Sips 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.

Exemple de réponse

            {
  "redirectionUrl": "http://www.acssiteweb.com",
  "paReqMessage": "eJxVUU1zgj...Rv8P/AJQjttc\u003d",
  "redirectionData": "uqjeV+Keg...MAwXk2jDJAe2TI\u003d",
  "redirectionStatusCode": "00",
  "messageVersion": "0.1",
  "seal": "3c40cf8c12a8eebdfc114c83db8f944b77932b03814d8bf43ea792c20d05e7a6"
}

        
                  <walletCheckEnrollmentResponse xmlns="urn:sips:cn:contract:office:checkout:v2">
         <output>
            <responseCode>00</responseCode>
            <redirectionUrl>https://payment-web.test.sips-services.com/paymentprovider/init</redirectionUrl>
            <paReqMessage>eJxVUctuwjAQ..../AVQptqQ=</paReqMessage>
            <redirectionData>RSs7cZyL1DqsVs...vceJKsC4lg</redirectionData>
            <messageVersion>0.1</messageVersion>
         </output>
      </walletCheckEnrollmentResponse>
Retourner en haut de page Besoin d'aide ?

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 WL Sips.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres