paymentTokenInitialize

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

Initialize a payment token generation kinematic with “Sips In-App”.

Recommended interfaceVersion: IR_MB_2.55

It is advised to read the following documents before

Recommended
1. Developers
2. Connectors
3. In-App
Sips In-App JSON

Functional, technical documentation and user guides to help you to integrate WL Sips online payment solution.
Open in new tab Sips In-App JSON

Endpoints

PROD

https://office-server.sips-services.com/rs-services/v2/tokenInApp/paymentTokenInitialize

method

POST
TEST

https://office-server.test.sips-services.com/rs-services/v2/tokenInApp/paymentTokenInitialize

method

POST

Request

Required

interfaceVersion
presence

Required

Interface version

2.37
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

AR_WS_2.

Obsolete

AUT_WS_2.

Sips Office (SOAP/JSON) interface for the Worldline Sips authentication services.

AU_WS_2.

AU_WS: Sips Office (SOAP/JSON) interface for the Worldline Sips account update services.

CR_WS_2.

Sips Office (SOAP/JSON) interface for Cash Management functions.

DR_WS_2.

Sips Office (SOAP/JSON) interface for Diagnostic functions.

FR_WS_2.

Sips Office (SOAP) interface for Fraud functions.

HP_x.x

Sips Paypage and Sips Walletpage (POST) interface.

IR_MB_

Sips In-App (JSON) interface for Sips In-App functions.

IR_WS_

Sips Paypage and Sips Office (SOAP/JSON) interface.

MR_WS_2.

Sips Office (SOAP/JSON) interface for mandate management.

PMR_WS_2.

Sips Office (SOAP/JSON) interface for payment method repository information request functions.

TR_WS_2.

Sips Office (SOAP) interface for Token functions.

WMR_WS_2.

Sips Walletpage interface (SOAP/JSON).

WR_WS_2.

WR_WS: Sips Office (SOAP/JSON) interface for Wallet functions.
keyVersion

presence

Required

Interface version

2.37

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

Format

N15

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

presence

Required

Interface version

2.37

Format

ANS30(restricted values)

In the context of Sips In-App (example: mobile application), indicates at the time of the phase initialization, the name of the operation that was chosens (example: card payment).

List of values

ADDCARD

Adding a card to the Wallet Worldline Sips for the initialization phase of an Sips In-App transaction

CARDORDER

Card payment for the initialization phase of an Sips In-App transaction

GETWALLETDATA

Consulting the information of a Wallet Worldline Sips for the initialization phase of a transaction Sips In-App

PAYMENTPROVIDERORDER

Via an external partner for the initialization phase of an Sips In-App transaction

PAYMENTTOKENGENERATE

Generation of token for a payment Sips In-App

THREEDSECUREANDORDER

Card payment for the initialization phase of an Sips In-App transaction with 3-D Secure authentication

THREEDSECUREANDWALLETORDER

Payment means registered in the Wallet Worldline Sips for the initialization phase of a transaction Sips In-App with 3-D Secure authentication

WALLETORDER

Payment with the Wallet Worldline Sips for the initialization phase of an Sips In-App transaction
sdkVersion

presence

Required

Interface version

2.37

Format

ANS20

Version of the SDK used for a payment or operation Sips In-App (Eg. 2.0.4)
seal

presence

Required

Interface version

2.37

Format

ANS128

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

Optional

customerIpAddress

presence

Optional

Interface version

2.37

Format

ipAddress

Buyer’s IP address.
intermediateServiceProviderId

presence

Optional

Interface version

2.37

Format

AN30

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

presence

Optional

Interface version

2.37

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

Request sample

json

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

Response

Required

seal

presence

Required

Interface version

1.0

Format

ANS128

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

Optional

publicKeyValue

presence

Optional

Interface version

1.0

Format

ANS16

In the context of a payment via Sips In-App, value of the public key that Worldline Sips sent to merchant in the response of initialisation in order to encrypt the card data that the merchant will send to Worldline Sips.
redirectionStatusCode

presence

Optional

Interface version

1.0

Format

N2(restricted values)

Response code returned by Worldline Sips when redirecting (e.g. redirecting to the ACS, to Worldline Sips server…). Indicates whether redirecting is possible or not.
List of values
00
In response to paymentWebInit: transaction initialized

In response to walletCheckEnrollment and cardCheckEnrollment: Carte enrolled
01

In response to cardCheckEnrollment and walletCheckEnrollment: card non 3-D Secure enrolled

03

Merchant contract invalid

10

Undefinied card enrollment (in response to cardCheckEnrollment and walletCheckEnrollment only)

12

Invalid transaction, check parameters transferred in the request

14

Invalid payment mean data (ex: PAN)

30

Format error (Webinit ERROR)

34

Suspicion of fraud, signature error (Webinit ERROR)

80

Error during DS interrogation

89

MPI session expired

91

Merchant not configured in the 3-D Secire server
94
In response to paymentWebInit: transaction duplicated. The transactionReference of this transaction has already been used

In response to cardCheckEnrollment or walletCheckEnrollment: error during the enrollment verification call
99

Internal error
redirectionStatusMessage

presence

Optional

Interface version

1.0

Format

ANS50

Additional information that is returned with redirectionStatusCode.
redirectionUrl

presence

Optional

Interface version

1.0

Format

url

In case of an enrollment check, contains the redirection URL to the ACS required for the cardholder authentication. In case of Sips In-App payment, contains the URL of the next request. In case of 3-D Secure Standalone, contains the redirection URL to the ACS required for the cardholder authentication.
redirectionVersion
presence

Optional

Interface version

1.0
Format
AN20 (restricted String)
Version of the redirection message.

Response sample

json

            {
  "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

Filter

Interface version	Data	Attendance
2.37	`customerIpAddress`	Request
2.37	`intermediateServiceProviderId`	Request
2.37	`sealAlgorithm`	Request
2.37	`interfaceVersion`	Request
2.37	`keyVersion`	Request
2.37	`merchantId`	Request
2.37	`sdkOperationName`	Request
2.37	`sdkVersion`	Request
2.37	`seal`	Request/Response
1.0	`publicKeyValue`	Response
1.0	`redirectionStatusCode`	Response
1.0	`redirectionStatusMessage`	Response
1.0	`redirectionUrl`	Response
1.0	`redirectionVersion`	Response

Need help?

Consulting the faq

WL SIPS DOCS

paymentTokenInitialize

It is advised to read the following documents before

Sips In-App JSON

Endpoints

Request

Required

`interfaceVersion`

`keyVersion`

`merchantId`

`sdkOperationName`

`sdkVersion`

`seal`

Optional

`customerIpAddress`

`intermediateServiceProviderId`

`sealAlgorithm`

Request sample

Response

Required

`seal`

Optional

`publicKeyValue`

`redirectionStatusCode`

`redirectionStatusMessage`

`redirectionUrl`

`redirectionVersion`

Response sample

Changelog

Need help?