transactionToToken

To search in the page use Ctrl+F on your keyboard

This function makes it possible to retrieve the token pan from a transaction.

Recommended interfaceVersion: TR_WS_2.55

Endpoints

json
soap

PROD

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

method

POST
TEST

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

method

POST

PROD

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

method

POST
TEST

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

method

POST

Request

Required

interfaceVersion
presence

Required

Interface version

2.0
Format
AN20(restricted String)
Version of the interface used. It is composed of a prefix that varies according to the function used and a version number (e.g. IR_WS_2.47).

Please refer to the function page for the value to use. Use the latest interface version number.

List of values

TR_WS_2.

Sips Office (SOAP) interface for Token functions.
keyVersion

presence

Required

Interface version

2.0

Format

N10

Version of the merchant’s secret key used to calculate the imprint of the message (key stored by the merchant to verify the imprint of the automatic and manual notifications).
merchantId

presence

Required

Interface version

2.0

Format

N15

Identifier of the shop, this value is provided to the merchant by Worldline Sips during the shop registration.
seal

presence

Required

Interface version

2.0

Format

ANS128

Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.

Optional

fromMerchantId

presence

Optional

Interface version

2.0

Format

AN15

merchantId of the transaction from which an extended duplication is done .
fromTransactionReference

presence

Optional

Interface version

2.0

Format

AN35

Reference for the original transaction during a duplication operation or a transaction completion to reference the authorisation.
intermediateServiceProviderId

presence

Optional

Interface version

2.12

Format

AN30

Identifier of the Service used by the merchant for the exchanges with the Worldline Sips platform.
merchantExternalId

presence

Optional

Interface version

2.0

Format

ANS35

External identifier provided by the merchant for its own use.
s10FromTransactionReference

presence

Optional

Interface version

2.6

Format

Container

Contains the identification of the original transaction (to be compliant with Worldline Sips 1.0).
Contains
- s10FromTransactionIdDate
  
  presence
  
  Optional
  
  Interface version
  
  2.6
  
  Format
  
  N8(YYYYMMDD)
  
  Date the original transaction was processed on the Worldline Sips server (expressed in the Worldline Sips server time zone).Always used with s10FromTransactionId.
- s10FromTransactionId
  
  presence
  
  Optional
  
  Interface version
  
  2.6
  
  Format
  
  N6
  
  Alternative identifier for the original transaction during a duplication and recycle operation (to be compliant with Worldline Sips 1.0).Always used with s10FromTransactionIdDate.
sealAlgorithm

presence

Optional

Interface version

2.12

Format

ANS20(restricted values)

Algorithm applied to calculate the seal encryption.

List of values

HMAC-SHA-256

The encryption algorithm applied is HMAC-SHA-256

HMAC-SHA-512

The encryption algorithm applied is HMAC-SHA-512

SHA-256

The encryption algorithm applied is 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>

Response

Required

seal

presence

Required

Interface version

2.0

Format

ANS128

Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.

Optional

cardExpiryDate

presence

Optional

Interface version

2.0

Format

N6(YYYYMM)

Card expiry date. If the card does not have any expiry date, this field is empty.
errorFieldName

presence

Optional

Interface version

2.21

Format

ANS50

Error field name of the incoming request. Present when responseCode = 12 or 30.
fromMerchantId

presence

Optional

Interface version

2.0

Format

AN15

merchantId of the transaction from which an extended duplication is done .
fromTransactionReference

presence

Optional

Interface version

2.0

Format

AN35

Reference for the original transaction during a duplication operation or a transaction completion to reference the authorisation.
merchantExternalId

presence

Optional

Interface version

2.0

Format

ANS35

External identifier provided by the merchant for its own use.
merchantId

presence

Optional

Interface version

2.0

Format

N15

Identifier of the shop, this value is provided to the merchant by Worldline Sips during the shop registration.
paymentMeanBrand

presence

Optional

Interface version

2.0

Format

ANS20(restricted values)

Name of the payment method that is used. It is related to one paymentMeanType.

List of values

1EUROCOM

Cofidis Pay 5x10x20x Acquisition contract: ONLINE_CREDIT

3XCBCOFINOGA

Depreciated. Cofinoga 3xCB paymentMeanBrandType: CARD

ACCEPTGIRO

AcceptGiro paymentMeanBrandType: CREDIT_TRANSFER

AIRPLUS

Airplus card paymentMeanBrandType: CARD

AIRPLUS_LOGEE

Airplus card paymentMeanBrandType: CARD

AMEX

American Express card paymentMeanBrandType: CARD

AMEX_LOGEE

American Express card paymentMeanBrandType: CARD

AURORE

CPAY card paymentMeanBrandType: CARD

BCACB_3X

Payment in 3 times with Floa Bank CB paymentMeanBrandType: ONLINE_CREDIT

BCACB_4X

Payment in 4 times with Floa Bank CB paymentMeanBrandType: ONLINE_CREDIT

BCACUP

CUP card of Floa Bank paymentMeanBrandType: CARD

BCMC

Bancontact card paymentMeanBrandType: CARD

CACF_3X

CACF payment in 3 installments paymentMeanBrandType: ONLINE_CREDIT

CACF_3XSANSFRAIS

CACF payment in 3 installments free of charge paymentMeanBrandType: ONLINE_CREDIT

CACF_4X

CACF payment in 4 installments paymentMeanBrandType: ONLINE_CREDIT

CACF_4XSANSFRAIS

CACF payment in 4 installments free of charge 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

China UnionPay card paymentMeanBrandType: CARD

CVA

Visa Aurore card 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

Maestro card (Mastercard) paymentMeanBrandType: CARD

MASTERCARD

Mastercard card paymentMeanBrandType: CARD

MASTERPASS

Deprecated - MasterPass paymentMeanBrandType:

ONEY34X

Payment in 3 or 4 times with Oney paymentMeanBrandType: ONLINE_CREDIT

PAYLIB

Paylib paymentMeanBrandType:

PAYPAL

Paypal paymentMeanBrandType: WALLET

PAYTRAIL

Paytrail paymentMeanBrandType: CREDIT_TRANSFER

PAY_BY_BANK

SEPA credit transfer paymentMeanBrandType: CREDIT_TRANSFER

SEPA_DIRECT_DEBIT

SDD (SEPA Direct Debit) paymentMeanBrandType: DIRECT_DEBIT

SOFINCO

Sofinco card paymentMeanBrandType: CARD

UNKNOWN

Unknown payment mean (this value can be returned by Worldline Sips but must not be used in a request)

VISA

Visa card paymentMeanBrandType: CARD

VISACHECKOUT

Deprecated - Visa Checkout wallet paymentMeanBrandType: WALLET

VISA_ELECTRON

Carte Visa Electron paymentMeanBrandType: CARD

VPAY

VPAY card (Visa) paymentMeanBrandType: CARD
responseCode

presence

Optional

Interface version

2.0

Format

N2(restricted values)

Worldline Sips server response code.
List of values
00

Operation accepted

01

For panToToken and tokenToPan methods, partial success

02

Request of authorized on via telephone with the issuer because of exceeding the card authorization threshold

03

Invalid merchant contract

05

Refused authorization

11

Used for differed check. The PAN is blocked

12

Invalid transaction. Please check the request parameters

14

Invalid PAN or payment mean data check is failed (e.g. card number or the visual cryptogram of the card or AVS address)

17

Customer cancellation
24
In response to a cash management operation: operation not authorized. The operation you wish to perform is not compliant with the transaction status or another operation is in progress at the same time

In response to a payment creation: operation rejected, request already carried out with the same data and the same parameters
25

Transaction unknown by Worldline Sips

30

Format error

34

Fraud suspicion (seal erroneous)

40

Function not supported: the operation that you wish to perform is not part of the operation type for which you are authorized

51

Amount too high

54

Payment mean expiry date is past

55

Merchant doesn’t accept prepaid cards

57

Refund operation refused because the original transaction was subject of an unpaid

60

Transaction pending

62

Waiting the confirmation for the transaction (used by PayPal 1.0)

63

Security rules not observed, transaction stopped

75

Number of attempts to enter the data of the payment mean from Sips Paypage is exceeded

90

Service temporarily not available

94

Duplicated transaction: the transactionReference has been used previously

97

Session expired (no action from the user during 15 minutes), transaction refused

99

Temporarily problem with the payment server
s10FromTransactionReference

presence

Optional

Interface version

2.6

Format

Container

Contains the identification of the original transaction (to be compliant with Worldline Sips 1.0).
Contains
- s10FromTransactionIdDate
  
  presence
  
  Optional
  
  Interface version
  
  2.6
  
  Format
  
  N8(YYYYMMDD)
  
  Date the original transaction was processed on the Worldline Sips server (expressed in the Worldline Sips server time zone).Always used with s10FromTransactionId.
- s10FromTransactionId
  
  presence
  
  Optional
  
  Interface version
  
  2.6
  
  Format
  
  N6
  
  Alternative identifier for the original transaction during a duplication and recycle operation (to be compliant with Worldline Sips 1.0).Always used with s10FromTransactionIdDate.
tokenPan
presence

Optional

Interface version

2.0
Format
AN35(restricted String)
Unique identifier for a PAN returned by the Worldline Sips server via the AWL token server in a merchant-oriented format (the format is a parameter in the merchant’s configuration).

Response sample

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

Filter

Interface version	Data	Attendance	Container
2.0	`fromMerchantId`	Request/Response
2.0	`fromTransactionReference`	Request/Response
2.12	`intermediateServiceProviderId`	Request
2.0	`merchantExternalId`	Request/Response
2.6	`s10FromTransactionReference`	Request/Response
2.6	`s10FromTransactionIdDate`	Container	`s10FromTransactionReference`
2.6	`s10FromTransactionId`	Container	`s10FromTransactionReference`
2.12	`sealAlgorithm`	Request
2.0	`interfaceVersion`	Request
2.0	`keyVersion`	Request
2.0	`merchantId`	Request/Response
2.0	`seal`	Request/Response
2.0	`cardExpiryDate`	Response
2.21	`errorFieldName`	Response
2.0	`paymentMeanBrand`	Response
2.0	`responseCode`	Response
2.0	`tokenPan`	Response

Need help?

Consulting the faq

WL SIPS DOCS

transactionToToken

Endpoints

Request

Required

`interfaceVersion`

`keyVersion`

`merchantId`

`seal`

Optional

`fromMerchantId`

`fromTransactionReference`

`intermediateServiceProviderId`

`merchantExternalId`

`s10FromTransactionReference`

`s10FromTransactionIdDate`

`s10FromTransactionId`

`sealAlgorithm`

Request sample

Response

Required

`seal`

Optional

`cardExpiryDate`

`errorFieldName`

`fromMerchantId`

`fromTransactionReference`

`merchantExternalId`

`merchantId`

`paymentMeanBrand`

`responseCode`

`s10FromTransactionReference`

`s10FromTransactionIdDate`

`s10FromTransactionId`

`tokenPan`

Response sample

Changelog

Need help?