logo Mercanet

Release 24.6

aller directement au contenu

Rechercher par mots clés

paymentTokenInitialize

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

Initialise une cinématique de génération d’un token de paiement avec “In-App”.

interfaceVersion recommandée : IR_MB_3.0

Avant de lire ce document nous vous conseillons

  • PROD
    https://office-server.mercanet.com/rs-services/v2/tokenInApp/paymentTokenInitialize
    méthode
    POST
  • TEST
    https://office-server-mercanet.test.sips-services.com/rs-services/v2/tokenInApp/paymentTokenInitialize
    méthode
    POST

Obligatoire

  • interfaceVersion
    présence
    Obligatoire
    Interface version
    2.37

    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
    AR_WS_2.
    Obsolète
    AUT_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les services d’authentification Mercanet
    AU_WS_2.
    AU_WS: interface Office (M2M) (SOAP/JSON) pour les services de mise à jour de compte Mercanet.
    CR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions de gestion de caisse.
    DR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions de diagnostique.
    FR_WS_2.
    interface Office (M2M) (SOAP) interface pour les fonctions de fraude.
    HP_x.x
    interface Paypage et Walletpage (POST).
    IR_MB_
    interface In-App (JSON) pour les fonctions In-App.
    IR_WS_
    interface Paypage et Office (M2M) (SOAP/JSON).
    MR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions liées aux mandats.
    PMR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions de demande d’information sur le référentiel des moyens de paiement.
    TR_WS_2.
    interface Office (M2M) (SOAP) pour les fonctions de token.
    WMR_WS_2.
    interface Walletpage(SOAP/JSON).
    WR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions liées au wallet.
  • keyVersion
    présence
    Obligatoire
    Interface version
    2.37

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

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

  • sdkOperationName
    présence
    Obligatoire
    Interface version
    2.37

    Pour un paiement 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 Mercanet pour la phase d’initialisation d’une transaction In-App
    CARDORDER
    Paiement par carte pour la phase d’initialisation d’une transaction In-App
    GETWALLETDATA
    Consultation des informations d’un Wallet Mercanet pour la phase d’initialisation d’une transaction In-App
    PAYMENTPROVIDERORDER
    Paiement via un partenaire externe pour la phase d’initialisation d’une transaction In-App
    PAYMENTTOKENGENERATE
    Génération d’un Token pour une transaction In-App
    THREEDSECUREANDORDER
    Paiement par carte pour la phase d’initialisation d’une transaction In-App avec authentification 3-D Secure
    THREEDSECUREANDWALLETORDER
    Paiement avec un moyen de paiement enregistré dans le Wallet Mercanet pour la phase d’initialisation d’une transaction In-App avec authentification 3-D Secure
    WALLETORDER
    Paiement avec un Wallet Mercanet pour la phase d’initialisation d’une transaction In-App
  • sdkVersion
    présence
    Obligatoire
    Interface version
    2.37

    Version de la librairie utilisée pour un paiement ou opération In-App (ex : 2.0.4)

  • seal
    présence
    Obligatoire
    Interface version
    2.37

    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

            {
    "interfaceVersion" : "IR_MB_2.37",
    "keyVersion" : "1",
    "merchantId" : "011223344550000",
    "sdkOperationName" : "PAYMENTTOKENGENERATE",
    "sdkVersion" : "SDK100",
    "seal" : "a5fc2c68e7051671c7b81c70ba971310b8d6188360199922cb3bd57778f3ffa4"
}

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

Exemple de réponse

            {
  "publicKeyValue":"30820122...10001",
  "redirectionStatusCode":"00",
  "redirectionStatusMessage":"Process succeeded",
  "redirectionUrl":"https://office-server.sips-services.com/rs-api/public/v2/tokenInApp/paymentTokenGenerate",
  "redirectionVersion":"IR_MB_2.37",
  "seal":"48670660a9167df5734d8f11546ee1d296557055e5861e8e2d1b85d6de7357fb"
}

Changelog


Interface version Donnée Présence Conteneur
2.37 customerIpAddress Requête
2.37 intermediateServiceProviderId Requête
2.37 sealAlgorithm Requête
2.37 interfaceVersion Requête
2.37 keyVersion Requête
2.37 merchantId Requête
2.37 sdkOperationName Requête
2.37 sdkVersion Requête
2.37 seal Requête/Réponse
1.0 publicKeyValue Réponse
1.0 redirectionStatusCode Réponse
1.0 redirectionStatusMessage Réponse
1.0 redirectionUrl Réponse
1.0 redirectionVersion Réponse
Retourner en haut de page Besoin d'aide ?

Besoin d'aide ?

Contacter le support
Fermer