logo Sogenactif

Release 22.6

aller directement au contenu

Rechercher par mots clés

walletInitialize

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

Cette fonction permet d’effectuer plusieurs types de cinématiques de gestion du Wallet avec “ (consultation du contenu d’un wallet, ajout et suppression d’une carte dans le wallet).”

Avant de lire ce document nous vous conseillons

  • PROD
    https://office-server.sogenactif.com/rs-services/v2/walletInApp/walletInitialize
    méthode
    POST
  • TEST
    https://office-server-sogenactif.test.sips-services.com/rs-services/v2/walletInApp/walletInitialize
    méthode
    POST

Obligatoire

  • interfaceVersion
    présence
    Obligatoire
    Interface version
    1.0

    Valeur et numéro de version de l’interface utilisée.

    Liste des valeurs
    AR_WS_2.
    Obsolète
    AUT_WS_2.
    AUT_WS: interface Sogenactif Office Serveur (SOAP/JSON) pour les services d’authentification Sogenactif 2.x: version référencée dans la documentation de la fonction utilisée par le Commerçant.
    CPR_WS_2.
    Obsolète
    CR_WS_2.
    CR_WS: interface Sogenactif Office Serveur (SOAP/JSON) pour les fonctions de gestion de caisse 2.x: version des connecteurs utilisée par le Commerçant
    DR_WS_2.
    DR_WS: interface Sogenactif Office Serveur (SOAP/JSON) pour les fonctions de diagnostic 2.x: version des connecteurs utilisée par le Commerçant
    FR_WS_2.
    FR_WS: interface Sogenactif Office Serveur (SOAP) interface pour les fonctions de fraude 2.x: version des connecteurs utilisée par le Commerçant
    HP_x.x
    HP: interface Sogenactif Paypage (POST) x.x: version des connecteurs utilisée par le Commerçant
    IR_MB_
    IR_MB: interface Sogenactif In-App (JSON) pour les fonctions Sogenactif In-App 1.x: version des connecteurs utilisée par le Commerçant
    IR_WS_
    IR_WS: interface Sogenactif Paypage (SOAP/JSON) x.x: version des connecteurs utilisée par le Commerçant
    IR_WS_2.
    IR_WS: interface Sogenactif Office Serveur (SOAP/JSON) pour les fonctions de requêtes de paiement 2.x: version des connecteurs utilisée par le Commerçant
    MR_WS_2.
    MR_WS : interface Sogenactif Office Serveur (SOAP/JSON) pour les fonctions liées aux mandats 2.x: version des connecteurs utilisée par le Commerçant
    OR_WS_1.0
    OR_WS: interface Sogenactif Office Serveur (SOAP) pour les fonctions Sogenactif Office Serveur 1.0: version des connecteurs utilisée par le Commerçant
    PMR_WS_2.
    PMR_WS: interface Sogenactif Office Serveur (SOAP/JSON) pour les fonctions de demande d’information sur le référentiel des moyens de paiement 2.x: version des connecteurs utilisée par le Commerçant
    POR_WS_2.
    Obsolète
    TR_WS_2.
    TR_WS: interface Sogenactif Office Serveur (SOAP) pour les fonctions de token 2.x: version des connecteurs utilisée par le Commerçant
    WMR_WS_2.
    WMR_WS : interface Sogenactif Walletpage 2.x: version des connecteurs utilisée par le Commerçant
    WR_WS_2.
    WR_WS: interface Sogenactif Office Serveur (SOAP/JSON) pour les fonctions de portefeuille électronique 2.x: version des connecteurs utilisée par le Commerçant
  • keyVersion
    présence
    Obligatoire
    Interface version
    1.2

    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
    1.0

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

  • merchantWalletId
    présence
    Obligatoire
    Interface version
    1.0

    Identifiant du portefeuille virtuel du client.

  • sdkOperationName
    présence
    Obligatoire
    Interface version
    1.0

    Pour un paiement Sogenactif In-App (ex : application mobile), indique au moment de la phase d’initialisation, le nom de l’opération qui a été choisie (ex : paiement carte).

    Liste des valeurs
    ADDCARD
    Ajout d’une carte au Wallet Sogenactif pour la phase d’initialisation d’une transaction Sogenactif In-App
    CARDORDER
    Paiement par carte pour la phase d’initialisation d’une transaction Sogenactif In-App
    GETWALLETDATA
    Consultation des informations d’un Wallet Sogenactif pour la phase d’initialisation d’une transaction Sogenactif In-App
    PAYMENTPROVIDERORDER
    Paiement via un partenaire externe pour la phase d’initialisation d’une transaction Sogenactif In-App
    PAYMENTTOKENGENERATE
    Génération d’un Token pour une transaction Sogenactif In-App
    THREEDSECUREANDORDER
    Paiement par carte pour la phase d’initialisation d’une transaction Sogenactif In-App avec authentification 3-D Secure
    THREEDSECUREANDWALLETORDER
    Paiement avec un moyen de paiement enregistré dans le Wallet Sogenactif pour la phase d’initialisation d’une transaction Sogenactif In-App avec authentification 3-D Secure
    WALLETORDER
    Paiement avec un Wallet Sogenactif pour la phase d’initialisation d’une transaction Sogenactif In-App
  • seal
    présence
    Obligatoire
    Interface version
    1.2

    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

            {
  "automaticResponseUrl" : "https://automatic-response-url.fr/",
  "interfaceVersion" : "IR_MB_1.1",
  "keyVersion" : "1",
  "merchantId" : "011223344550000",
  "merchantWalletId" : "walletId01",
  "sdkOperationName" : "GETWALLETDATA",
  "sdkVersion" : "SDK100",
  "seal" : "4e586868b436245140b1fc96c363fd6b211907b4e742c9b4229499e148711288"
}
        

Obligatoire

  • seal
    présence
    Obligatoire
    Interface version
    1.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

  • publicKeyValue
    présence
    Optionnel
    Interface version
    1.0

    Dans le contexte d’un paiement via Sogenactif In-App, valeur de la clé publique envoyée par Sogenactif au commerçant en réponse de la requête d’initialisation permettant au commerçant de crypter les données carte à envoyer à Sogenactif.

  • redirectionData
    présence
    Optionnel
    Interface version
    1.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
    1.0

    Code réponse retourné par Sogenactif lors d’une redirection (exemple : redirection vers l’ACS, redirection vers le serveur Sogenactif). 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
  • redirectionStatusMessage
    présence
    Optionnel
    Interface version
    1.0

    Information complémentaire retournée en plus du redirectionStatusCode.

  • redirectionUrl
    présence
    Optionnel
    Interface version
    1.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.

  • redirectionVersion
    présence
    Optionnel
    Interface version
    1.0

    Version du message de redirection.

Exemple de réponse

            {
  "publicKeyValue":"30820122...10001",
  "redirectionData":"4AgbsrffvP...1_H2YKez1ncQ",
  "redirectionStatusCode":"00",
  "redirectionStatusMessage":"OneClick available for provided merchant",
  "redirectionUrl":"https://office-server.sips-services.com/rs-api/public/v2/walletInApp/getWalletData",
  "redirectionVersion":"IR_MB_1.1",
  "seal":"2cbb1daf03059d015e8523ca3e270a36a0614bbe172178c8b3b7cdf53ea7a5fc"
}
        
Retourner en haut de page Besoin d'aide ?

Besoin d'aide ?

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

Paramètres