panToToken

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

Cette opération permet de tokéniser un numéro de carte.

interfaceVersion recommandée : TR_WS_2.53

Urls des environnements

json
soap

PROD

https://office-server.sips-services.com/rs-services/v2/token/panToToken

méthode

POST
TEST

https://office-server.test.sips-services.com/rs-services/v2/token/panToToken

méthode

POST

PROD

https://office-server.sips-services.com/services/v2/token?wsdl

méthode

POST
TEST

https://office-server.test.sips-services.com/services/v2/token?wsdl

méthode

POST

Requête

Obligatoire

interfaceVersion
présence

Obligatoire

Interface version

2.0
Format
AN20(restricted String)
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

TR_WS_2.

interface Sips Office (SOAP) pour les fonctions de token.
keyVersion

présence

Obligatoire

Interface version

2.0

Format

N10

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

Format

N15

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

présence

Obligatoire

Interface version

2.0

Format

ANS128

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

intermediateServiceProviderId

présence

Optionnel

Interface version

2.12

Format

AN30

Identifiant du service utilisé par le commerçant pour les échanges de flux avec la plateforme Worldline Sips.
panDataList

présence

Optionnel

Interface version

2.0

Format

Composite list

Liste des PAN à convertir en token PAN.
Contient
- panData
  
  présence
  
  Optionnel
  
  Interface version
  
  2.0
  
  Format
  
  Container
  
  Contient les informations sur le PAN à convertir en token PAN.
  Contient
  - cardExpiryDate
    
    présence
    
    Optionnel
    
    Interface version
    
    2.0
    
    Format
    
    N6(YYYYMM)
    
    Date d’expiration de la carte. Si la carte n’a pas de date d’expiration, ce champ doit être vide.
  - pan
    
    présence
    
    Optionnel
    
    Interface version
    
    2.0
    
    Format
    
    N19 or ANS35
    
    PAN (Primary Account Number).Peut contenir un Token PAN convertis à partir d’un PAN dans le conteneur responsePanData (auquel cas il sera au format ANS35)
  - panId
    
    présence
    
    Optionnel
    
    Interface version
    
    2.0
    
    Format
    
    N5
    
    Numéro de séquence du PAN dans la liste. Ce numéro est identique entre la requête et la réponse.
paymentToken

présence

Optionnel

Interface version

2.39

Format

ANS1024

Jeton de paiement Hosted Fields à transmettre lors des appels à Sips Office et permettant de trouver les informations de paiement carte lors de paiement classique ou 3-D Secure, par wallet ou non.
sealAlgorithm

présence

Optionnel

Interface version

2.12

Format

ANS20(restricted values)

Algorithme de cryptage utilisé pour le calcul du sceau.

Liste des valeurs

HMAC-SHA-256

L’algorithme de cryptage utilisé est HMAC-SHA-256

HMAC-SHA-512

L’algorithme de cryptage utilisé est HMAC-SHA-512

SHA-256

L’algorithme de cryptage utilisé est SHA-256

            {
  "interfaceVersion": "TR_WS_2.0",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "panDataList": [
    {
      "pan": "4907000000000600",
      "panId": "1"
    }
  ],
  "userId": "uid",
  "seal": "8f95bd9cc96c7723b530f0492c9fed50399b94f9b0c91c113b4f56a97fe2cb8f"
}

                  <urn:panToToken>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:interfaceVersion>TR_WS_2.0</urn:interfaceVersion>
            <urn:userId>uid</urn:userId>
            <urn:panDataList>
               <urn:panData>
                  <urn:panId>2</urn:panId>
                  <urn:pan>4907000000000600</urn:pan>
               </urn:panData>
            </urn:panDataList>
         </urn:input>
      </urn:panToToken>

Réponse

Obligatoire

seal

présence

Obligatoire

Interface version

2.0

Format

ANS128

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

Format

ANS50

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

présence

Optionnel

Interface version

2.0

Format

N2(restricted values)

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

présence

Optionnel

Interface version

2.0

Format

Composite list

Liste des réponses envoyées lors de la tokenisation de PAN.
Contient
- responseTokenPanData
  
  présence
  
  Optionnel
  
  Interface version
  
  2.0
  
  Format
  
  Container
  
  Réponses envoyées lors de la tokenisation de PAN.
  Contient
  - panId
    
    présence
    
    Optionnel
    
    Interface version
    
    2.0
    
    Format
    
    N5
    
    Numéro de séquence du PAN dans la liste. Ce numéro est identique entre la requête et la réponse.
  - tokenPan
    
    présence
    
    Optionnel
    
    Interface version
    
    2.0
    
    Format
    
    AN35(restricted String)
    
    Identifiant unique d’un PAN retourné par le serveur Worldline Sips via le serveur de token AWL dans un format orienté commerçant (Le format est un paramètre de la configuration du commerçant).
  - tokenResponseCode
    
    présence
    
    Optionnel
    
    Interface version
    
    2.0
    
    Format
    
    N2(restricted values)
    
    Code réponse de la conversion de chaque PAN vers les token PAN et inversement.
    
    Liste des valeurs
    
    00
    
    Les opérations sont acceptées
    
    01
    
    Au moins une des opérations n’est pas acceptée
    
    03
    
    Contrat du Commerçant invalide
    
    40
    
    Le marchandId n’a pas l’option token
    
    90
    
    Erreur technique du tokenizer
    
    99
    
    Erreur technique avec la requête

Exemple de réponse

json
soap

            {
  "responseCode": "00",
  "responseTokenPanDataList": [
    {
      "tokenResponseCode": "00",
      "panId": "1",
      "tokenPan": "490700h719850600"
    }
  ],
  "seal": "a16689b166fa9a508341fad15563633bb83367d009d3f2507c95bc71cd9f1ad5"
}

                  <panToTokenResponse xmlns="urn:sips:cn:contract:office:token:v2">
         <output>
            <responseCode>00</responseCode>
            <responseTokenPanDataList>
               <responseTokenPanData>
                  <tokenResponseCode>00</tokenResponseCode>
                  <panId>2</panId>
                  <tokenPan>490700h719850600</tokenPan>
               </responseTokenPanData>
            </responseTokenPanDataList>
         </output>
      </panToTokenResponse>

Changelog

Filtre

Interface version	Donnée	Présence	Conteneur
2.12	`intermediateServiceProviderId`	Requête
2.0	`panDataList`	Requête
2.0	`panData`	Conteneur	`panDataList`
2.0	`cardExpiryDate`	Conteneur	`panData`
2.0	`pan`	Conteneur	`panData`
2.0	`panId`	Conteneur	`panData` `responseTokenPanData`
2.39	`paymentToken`	Requête
2.12	`sealAlgorithm`	Requête
2.0	`interfaceVersion`	Requête
2.0	`keyVersion`	Requête
2.0	`merchantId`	Requête
2.0	`seal`	Requête/Réponse
2.21	`errorFieldName`	Réponse
2.0	`responseCode`	Réponse
2.0	`responseTokenPanDataList`	Réponse
2.0	`responseTokenPanData`	Conteneur	`responseTokenPanDataList`
2.0	`tokenPan`	Conteneur	`responseTokenPanData`
2.0	`tokenResponseCode`	Conteneur	`responseTokenPanData`

Besoin d'aide ?

Consulter la faq

WL SIPS DOCS

panToToken

Urls des environnements

Requête

Obligatoire

`interfaceVersion`

`keyVersion`

`merchantId`

`seal`

Optionnel

`intermediateServiceProviderId`

`panDataList`

`panData`

`cardExpiryDate`

`pan`

`panId`

`paymentToken`

`sealAlgorithm`

Exemple de requête

Réponse

Obligatoire

`seal`

Optionnel

`errorFieldName`

`responseCode`

`responseTokenPanDataList`

`responseTokenPanData`

`panId`

`tokenPan`

`tokenResponseCode`

Exemple de réponse

Changelog

Besoin d'aide ?