transactionToToken

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

Cette fonction permet de transformer le PAN d’une transaction existante en token.

interfaceVersion recommandée : TR_WS_2.55

Urls des environnements

json
soap

PROD

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

méthode

POST
TEST

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

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

fromMerchantId

présence

Optionnel

Interface version

2.0

Format

AN15

merchantId de la transaction de référence utilisée pour la duplication étendue.
fromTransactionReference

présence

Optionnel

Interface version

2.0

Format

AN35

Référence de la transaction d’origine lors d’une opération de duplication ou d’enregistrement de transaction (TC) pour référencer l’autorisation.
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.
merchantExternalId

présence

Optionnel

Interface version

2.0

Format

ANS35

Identifiant externe fourni par le commerçant pour ses besoins propres.
s10FromTransactionReference

présence

Optionnel

Interface version

2.6

Format

Container

Contient les informations sur l’identification de la transaction d’origine, compatible avec Worldline Sips 1.0
Contient
- s10FromTransactionIdDate
  
  présence
  
  Optionnel
  
  Interface version
  
  2.6
  
  Format
  
  N8(YYYYMMDD)
  
  Date de la transaction d’origine lors d’une opération de duplication ou de recyclage (exprimée dans le time zone du serveur Worldline Sips).Cette date est toujours utilisée avec la donnée s10FromTransactionId.
- s10FromTransactionId
  
  présence
  
  Optionnel
  
  Interface version
  
  2.6
  
  Format
  
  N6
  
  Identifiant alternatif de la transaction d’origine, compatible avec Worldline Sips 1.0, lors d’une opération de duplication ou de recyclage.Cet identifiant est toujours utilisé avec la donnée s10FromTransactionIdDate.
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

            {
  "fromMerchantId": "024729465300006",
  "fromTransactionReference": "SIM20170613140621",
  "interfaceVersion": "TR_WS_2.20",
  "keyVersion": "1",
  "merchantExternalId": "myMerchantExternalId",
  "merchantId": "024729465300101",
  "seal": "9f0a2e696242acdb3f966fed16bfd91d540531b9e259f41c474f52fb2c62345b"
}

            <urn:transactionToToken>
    <urn:input>
        <urn:fromMerchantId>024729465300006</urn:fromMerchantId>
        <urn:fromTransactionReference>SIM20170613140621</urn:fromTransactionReference>
        <urn:interfaceVersion>TR_WS_2.18</urn:interfaceVersion>
        <urn:keyVersion>1</urn:keyVersion>
        <urn:merchantExternalId>myMerchantExternalId</urn:merchantExternalId>
        <urn:merchantId>024729465300101</urn:merchantId>
    </urn:input>
</urn:transactionToToken>

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

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

présence

Optionnel

Interface version

2.0

Format

AN15

merchantId de la transaction de référence utilisée pour la duplication étendue.
fromTransactionReference

présence

Optionnel

Interface version

2.0

Format

AN35

Référence de la transaction d’origine lors d’une opération de duplication ou d’enregistrement de transaction (TC) pour référencer l’autorisation.
merchantExternalId

présence

Optionnel

Interface version

2.0

Format

ANS35

Identifiant externe fourni par le commerçant pour ses besoins propres.
merchantId

présence

Optionnel

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

présence

Optionnel

Interface version

2.0

Format

ANS20(restricted values)

Nom du moyen de paiement utilisé. Il est lié à un paymentMeanType.

Liste des valeurs

1EUROCOM

Cofidis Pay 5x10x20x Contrat d’acquisition : ONLINE_CREDIT

3XCBCOFINOGA

Valeur Obsolète. Cofinoga 3xCB paymentMeanBrandType : CARD

ACCEPTGIRO

AcceptGiro paymentMeanBrandType : CREDIT_TRANSFER

AIRPLUS

Carte Airplus paymentMeanBrandType : CARD

AIRPLUS_LOGEE

Carte Airplus logée paymentMeanBrandType : CARD

AMEX

Carte American Express paymentMeanBrandType : CARD

AMEX_LOGEE

Carte American Express logée paymentMeanBrandType : CARD

AURORE

Carte CPAY paymentMeanBrandType : CARD

BCACB_3X

Floa Bank CB paiement en 3 fois paymentMeanBrandType : ONLINE_CREDIT

BCACB_4X

Floa Bank CB paiement en 4 fois paymentMeanBrandType : ONLINE_CREDIT

BCACUP

Carte CUP de Floa Bank paymentMeanBrandType : CARD

BCMC

Bancontact paymentMeanBrandType : CARD

CACF_3X

CACF paiement en 3 fois paymentMeanBrandType : ONLINE_CREDIT

CACF_3XSANSFRAIS

CACF paiement en 3 fois sans frais paymentMeanBrandType : ONLINE_CREDIT

CACF_4X

CACF paiement en 4 fois paymentMeanBrandType : ONLINE_CREDIT

CACF_4XSANSFRAIS

CACF paiement en 4 fois sans frais paymentMeanBrandType : ONLINE_CREDIT

CADHOC

Cadhoc paymentMeanBrandType : CARD

CADOCARTE

Cado Carte paymentMeanBrandType : CARD

CB

Carte Bancaire paymentMeanBrandType : CARD

CETELEM_3X

Cetelem 3xCB paymentMeanBrandType : ONLINE_CREDIT

CETELEM_4X

Cetelem 4xCB paymentMeanBrandType : ONLINE_CREDIT

COFIDIS_3X

Cofidis 3xCB paymentMeanBrandType : ONLINE_CREDIT

COFIDIS_4X

Cofidis 4xCB paymentMeanBrandType : ONLINE_CREDIT

CONECS

Titres Restaurants Dématérialisés Conecs paymentMeanBrandType : VOUCHER

CUP

Carte China UnionPay paymentMeanBrandType : CARD

CVA

Carte Visa Aurore paymentMeanBrandType : CARD

CVCO

Chèque-Vacances Connect paymentMeanBrandType : VOUCHER

DINERS

Carte Diners club international paymentMeanBrandType : CARD

FRANFINANCE_3X

Franfinance 3xCB paymentMeanBrandType : ONLINE_CREDIT

FRANFINANCE_4X

Franfinance 4xCB paymentMeanBrandType : ONLINE_CREDIT

GIROPAY

Giropay paymentMeanBrandType : CREDIT_TRANSFER

ILLICADO

Illicado paymentMeanBrandType : CARD

INCASSO

Incasso paymentMeanBrandType : DIRECT_DEBIT

INGHOMEPAY

PayButton ING Home’Pay paymentMeanBrandType : CREDIT_TRANSFER

JCB

Carte Japan Credit Bureau paymentMeanBrandType : CARD

LEPOTCOMMUN

Le Pot Commun paymentMeanBrandType : CARD

LYDIA

Lydia paymentMeanBrandType : PROVIDER

MAESTRO

Carte Maestro (Mastercard) paymentMeanBrandType : CARD

MASTERCARD

Carte Mastercard paymentMeanBrandType : CARD

MASTERPASS

Obsolète - Portefeuille virtuel MasterPass paymentMeanBrandType :

ONEY34X

Oney Paiement 3 fois ou 4 fois paymentMeanBrandType : ONLINE_CREDIT

PAYLIB

Portefeuille virtuel Paylib paymentMeanBrandType :

PAYPAL

Paypal paymentMeanBrandType : WALLET

PAYTRAIL

Paytrail paymentMeanBrandType : CREDIT_TRANSFER

PAY_BY_BANK

Virement bancaire SEPA paymentMeanBrandType : CREDIT_TRANSFER

SEPA_DIRECT_DEBIT

SDD (SEPA Direct Debit) paymentMeanBrandType : DIRECT_DEBIT

SOFINCO

Carte Sofinco paymentMeanBrandType : CARD

UNKNOWN

Moyen de paiement inconnu (cette valeur peut être retournée par Worldline Sips mais ne doit pas être utilisée dans une requête)

VISA

Carte Visa paymentMeanBrandType : CARD

VISACHECKOUT

Obsolète - Portefeuille virtuel Visa Checkout paymentMeanBrandType : WALLET

VISA_ELECTRON

Carte Visa Electron paymentMeanBrandType : CARD

VPAY

Carte VPAY (Visa) paymentMeanBrandType : CARD
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.
s10FromTransactionReference

présence

Optionnel

Interface version

2.6

Format

Container

Contient les informations sur l’identification de la transaction d’origine, compatible avec Worldline Sips 1.0
Contient
- s10FromTransactionIdDate
  
  présence
  
  Optionnel
  
  Interface version
  
  2.6
  
  Format
  
  N8(YYYYMMDD)
  
  Date de la transaction d’origine lors d’une opération de duplication ou de recyclage (exprimée dans le time zone du serveur Worldline Sips).Cette date est toujours utilisée avec la donnée s10FromTransactionId.
- s10FromTransactionId
  
  présence
  
  Optionnel
  
  Interface version
  
  2.6
  
  Format
  
  N6
  
  Identifiant alternatif de la transaction d’origine, compatible avec Worldline Sips 1.0, lors d’une opération de duplication ou de recyclage.Cet identifiant est toujours utilisé avec la donnée s10FromTransactionIdDate.
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).

Exemple de réponse

json
soap

            {
  "responseCode": "00",
  "merchantId": "024729465300101",
  "fromMerchantId": "024729465300006",
  "fromTransactionReference": "SIM20170613140621",
  "seal": "a8e229f12c98f5f2a1cf2a8def150691e2742410441675e308a4f9a695a14547",
  "merchantExternalId": "myMerchantExternalId",
  "tokenPan": "490700h719850600",
  "paymentMeanBrand": "VISA",
  "cardExpiryDate": "201802"
}

            <transactionToTokenResponse xmlns="urn:sips:cn:contract:office:token:v2">
    <output>
        <responseCode>00</responseCode>
        <merchantId>024729465300101</merchantId>
        <fromMerchantId>024729465300006</fromMerchantId>
        <fromTransactionReference>SIM20170613140621</fromTransactionReference>
        <merchantExternalId>myMerchantExternalId</merchantExternalId>
        <tokenPan>490700h719850600</tokenPan>
        <paymentMeanBrand>VISA</paymentMeanBrand>
        <cardExpiryDate>201802</cardExpiryDate>
    </output>
</transactionToTokenResponse>

Changelog

Filtre

Interface version	Donnée	Présence	Conteneur
2.0	`fromMerchantId`	Requête/Réponse
2.0	`fromTransactionReference`	Requête/Réponse
2.12	`intermediateServiceProviderId`	Requête
2.0	`merchantExternalId`	Requête/Réponse
2.6	`s10FromTransactionReference`	Requête/Réponse
2.6	`s10FromTransactionIdDate`	Conteneur	`s10FromTransactionReference`
2.6	`s10FromTransactionId`	Conteneur	`s10FromTransactionReference`
2.12	`sealAlgorithm`	Requête
2.0	`interfaceVersion`	Requête
2.0	`keyVersion`	Requête
2.0	`merchantId`	Requête/Réponse
2.0	`seal`	Requête/Réponse
2.0	`cardExpiryDate`	Réponse
2.21	`errorFieldName`	Réponse
2.0	`paymentMeanBrand`	Réponse
2.0	`responseCode`	Réponse
2.0	`tokenPan`	Réponse

Besoin d'aide ?

Consulter la faq

WL SIPS DOCS

transactionToToken

Urls des environnements

Requête

Obligatoire

`interfaceVersion`

`keyVersion`

`merchantId`

`seal`

Optionnel

`fromMerchantId`

`fromTransactionReference`

`intermediateServiceProviderId`

`merchantExternalId`

`s10FromTransactionReference`

`s10FromTransactionIdDate`

`s10FromTransactionId`

`sealAlgorithm`

Exemple de requête

Réponse

Obligatoire

`seal`

Optionnel

`cardExpiryDate`

`errorFieldName`

`fromMerchantId`

`fromTransactionReference`

`merchantExternalId`

`merchantId`

`paymentMeanBrand`

`responseCode`

`s10FromTransactionReference`

`s10FromTransactionIdDate`

`s10FromTransactionId`

`tokenPan`

Exemple de réponse

Changelog

Besoin d'aide ?