WL SIPS DOCS

Release 23.3

aller directement au contenu

Rechercher par mots clés

walletIssuerWalletInitialize

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

Cette requête permet d’initialiser un paiement one-click avec un wallet externe :

Une telle requête est obligatoire pour récupérer les données de redirection et l’url vers laquelle rediriger l’acheteur vers les pages d’authentification du wallet externe enrôlé dans un wallet Worldline Sips. Si l’étape d’initialisation a réussi, vous recevez en réponse une URL sécurisée (redirectionUrl) vers laquelle le client doit être redirigé pour poursuivre la procédure de paiement one-click. Cette redirection doit être réalisée par le biais d’un formulaire POST, voir la partie “Formulaire POST vers des fournisseurs externes”. Vous devez également spécifier dans la requête l’URL (merchantReturnUrl) vers laquelle le client sera redirigé à la fin du paiement one-click avec un wallet externe. Vous devez ensuite appeler le service walletIssuerWalletFinalize afin de finaliser la transaction.

interfaceVersion recommandée : IR_WS_2.49

  • PROD
    https://office-server.sips-services.com/rs-services/v2/checkout/walletIssuerWalletInitialize
    méthode
    POST
  • TEST
    https://office-server.test.sips-services.com/rs-services/v2/checkout/walletIssuerWalletInitialize
    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

Optionnel

Exemple de requête

            {
  "amount": "1000",
  "captureMode": "AUTHOR_CAPTURE",
  "currencyCode": "978",
  "customerIpAddress": "127.0.0.1",
  "interfaceVersion": "IR_WS_2.3",
  "keyVersion": "1",
  "merchantId": "023101122334455",
  "merchantReturnUrl": "http://www.yoursiteweb.com",
  "merchantTransactionDateTime": "2014-07-11T10:59:57.723+02:00",
  "orderChannel": "INTERNET",
  "paymentMeanBrand": "PAYLIB",
  " transactionReference": "TREFEXA2012",
  "merchantWalletId":"12",
  "seal": " 95e479c276d71a07c655f3c2db1bb8b483c0921e544d4af4cff3e220b04eb551"
}

        
                  <urn:walletIssuerWalletInitialize>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:transactionReference>TREFEXA2012</urn:transactionReference>
            <urn:interfaceVersion>IR_WS_2.2</urn:interfaceVersion>
            <urn:amount>2500</urn:amount>
            <urn:orderChannel>INTERNET</urn:orderChannel>
            <urn:currencyCode>978</urn:currencyCode>
            <urn:paymentMeanBrand>PAYLIB</urn:paymentMeanBrand>
            <urn:merchantReturnUrl>http://www.yoursiteweb.com</urn:merchantReturnUrl>
            <urn:merchantWalletId>12</urn:merchantWalletId>
            <urn:paymentMeanId>3</urn:paymentMeanId>
         </urn:input>
      </urn:walletIssuerWalletInitialize>

        

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.

  • issuerWalletType
    présence
    Optionnel
    Interface version
    2.0

    Identifiant fourni par l’émetteur du wallet pour identifier le moyen de paiement.

    Liste des valeurs
    BCMCMOBILE
    Bancontact Mobile
    MASTERPASS
    Obsolète - Masterpass
    MERCHANT_WALLET
    Wallet Worldline Sips
    PAYLIB
    Paylib
    VISACHECKOUT
    Obsolète - Visa Checkout
  • messageVersion
    présence
    Optionnel
    Interface version
    2.0

    Version des paramètres de redirection.

  • paymentProviderSessionId
    présence
    Optionnel
    Interface version
    2.0

    Identifiant de session calculé lors de l’initialisation d’‘un paiement Sips In-App ou via un Wallet externe avec Sips Office.

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

  • 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.0

    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

            {
  "responseCode": "00",
  "redirectionUrl": "https://private-payment.test.sips-services.com/paylib/FrontController",
  "redirectionData": "RSs7cZyL1DqsVso",
  "messageVersion": "0.1",
  "seal": "79cf30535e08b8c6c9cfdd55c343845947f8fea892ec0ea1db96378055f71de6"
}

        
                  <walletIssuerWalletInitializeResponse xmlns="urn:sips:cn:contract:office:checkout:v2">
         <output>
            <responseCode>00</responseCode>
            <redirectionUrl>https://private-payment.test.sips-services.com/paylib/FrontController</redirectionUrl>
            <redirectionData>RSs7cZyL1DqsVs...vceJKsC4lg</redirectionData>
            <messageVersion>0.1</messageVersion>
         </output>
      </walletIssuerWalletInitializeResponse>

        

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