WL SIPS DOCS

• alphabetic [aA-zZ]
• numeric [0-9]
• special _ . + - @
• space

• alphabetic [aA-zZ]
• numeric [0-9]
• special _ . ? * + - [ ] { } ^ $ | , ; : ! < > = & ~ # " ' ` ( ) % @ / \
  • The apostrophe character that is accepted is the 039 character from the iso 8859-1 table
  • The quotation mark character that is accepted is the 034 character from the iso 8859-1 table
• space,

• alphabetic [aA-zZ]
• numeric [0-9]
• special " ' ` _ + . - @ ,
  • The accepted apostrophe character is the 039 character from the iso 8859-1 table
  • The accepted quotation mark character is the 034 character from the iso 8859-1 table
• space
• Any character from the Unicode standard alphabets.

The following characters are accepted:

• alphabetic [aA-zZ]
• numeric [0-9]
• special _ . ? * + - [ ] { } ^ $ | , ; : ! < > = & ~ # " ' ` ( ) % @ / \
  • The accepted apostrophe character is the 039 character from the iso 8859-1 table
  • The accepted quotation mark character is the 034 character from the iso 8859-1 table
• space
• Any character from the Unicode standard alphabets.

• YYYY-MM-DD : Year, Month, Day, with '-' as a separator
• T : "T" static value indicating that the following is a time description.
• hh :mm :ss : Hours, Minutes, Seconds with ‘:’ as a separator. A fraction of a second can be added to this time using a dot or a comma as a separator.
• zzzzzz : time zone or time shift compared to UTC using one of the following formats: "Z" for zero meridian and "+hh:mm" or "-hh:mm" for other time zones.

acceptanceSystemApplicationId

ANS12

Identifier of the ultimate WL Sips application used for transmitting the authorisation request.

accord

Container

Information specific to the Oney card means of payment (formerly Accord card).

accordkdo

Container

Information specific to the Carte Cadeau Oney card means of payment (formerly Carte Cadeau Accord).

acquirerContractNumber

ANS128

Please see "contractNumber"

acquirerNativeResponseCode

ANS10

Response code returned by the acquirer, in its own codification, during an authorisation request.

acquirerReconciliationDetail

ANS512

Additional data for reconciliation of prepaid payments. This field contains the additional CB, Visa, Mastercard payment information.

Its detailed content is described in the documentation for each concerned means of payment.

acquirerResponseCode

AN2

Response code returned by the acquirer during an authorisation request.

Values: acquirerResponseCode

acquirerResponseIdentifier

ANS20

Please see "authorMessageReference".

acquirerResponseMessage

ANS512

Acquirer response message to the originator of the transaction (for example, message to be displayed to the holder or the cashier)..

acquisitionType

AN3

Acquisition type provided by the acquirer on the reconciliation report to specify whether the payment is a standard payment or a credit payment.

Values: acquisitionType

additionalAuthorisationNumber

N6

Additional authorisation number sent by the acquirer.

addPaymentMeanDate

N8

Enrollment date of the means of payment in the customer account on the merchant site.

addressAdditional1

ANU50

Addition 1 to the address.

addressAdditional2

ANU50

Addition 2 to the address.

addressAdditional3

ANU50

Addition 3 to the address.

addressDeliveryBillingMatchIndicator

A5

Specifies whether the delivery and the billing addresses are the same.

Values: booleanIndicator

addrOverride

ANS20

Indicator allowing the merchant to display the delivery address on PayPal pages. This indicator allows to override the address present in the PayPal account if necessary.

Values: addrOverride

agencyCode

ANS20

Identifier of the agency provided by the merchant.

airlineCarrierList

ANS53

Airline carrier list.

allowedCardArea

AN10

List identifier of card countries allowed to make a payment. Countries are grouped by geographical area.

Values: areaList

allowedCardCountryList

ANS128

List of card country codes allowed to make a payment. ISO 3166 list of country codes.

Values: countryList

allowedIpArea

ANS128

List identifier of IP countries allowed to make a payment.

Values: areaList

allowedIpCountryList

ANS128

List of buyer IP country codes allowed to make a payment

Values: countryList

amount

N12

Transaction amount. The amount must be transmitted in the smallest currency unit.

amountsList

N12

List of amounts for the occurrences for payment in instalments.

applePay

Container

Contains specific authentication information for ApplePay.

authentACSMethod

ANS20

Authentication method that the ACS applied to authenticate the cardholder.

Valeurs : authentACSMethod

authentACSTransId

ANS36

Universal transaction identifier assigned by the ACS to uniquely identify a transaction.

authentAmount

N12

Authentication amount.

authentCancelReason

N2

Reason for authentication cancellation.

Values: authentCancelReason

authentDateTime

ANS25

UTC date and time of the authentication.

authentDSMerchantName

ANS40

Identifier assigned by the Directory Server to uniquely identify the merchant.

authentDSTransId

ANS36

Universal transaction identifier assigned by the DS to uniquely identify a transaction.

authentExemptionReason

AN20

Exemption fixed by the issuer.

Values: authentExemptionReason

authentExemptionReasonList

ANU256

List of exemptions fixed by the issuer.

authenticationData

Container

Contains the information on the cardholder's authentication.

authenticationKey

ANS512

Authentication data provided by the merchant for Franfinance payment.

authenticationLevelBypass

ANS256

List of antifraud rules provided by the merchant to bypass current pre-authentication checks.

authenticationResult

Container

Contains the result information from the cardholder's authentification.

authentMessageVersion

ANS8

Version of the 3-D Secure protocol used (e.g. 2.1.0).

authentRedirectionUrl

URL

Redirection URL to an authentication server.

authentScoreValue

ANS10

Score value provided by the DS (Directory Server) to the ACS (Access Control Server).

authentThreedsServerTransId

ANS36

Universal transaction identifier assigned by the 3DS server to uniquely identify a transaction.

authentTransStatusReason

ANS50

Reason accompanying the authentication result communicated in the MPI of a 3D-Secure payment.

authorMessageReference

N6

Identifier shared with the acquirer during the authorisation process.

authorisationId

AN10/ANS32

Authorisation ID returned by the acquirer if the authorisation request is accepted.

authorisationLevelBypass

ANS256

List of antifraud rules provided by the merchant to bypass current pre-authorisation checks.

authorisationTypeCode

List of antifraud rules provided by the merchant to bypass current pre-authorisation checks.

authorisationTypeLabel

ANS50

Label of the authorisation request type.

Values: authorisationTypeLabel

automaticErrorResponseInitPOST

ANS512

URL provided by the merchant and notifying the url where the automatic response has to be sent in case of error during payment initialisation.

automaticResponseStatus

ANS20

State of the sending of the automatic response to the merchant's server for a transaction created using the Sips Paypage interface.

Values: automaticResponseStatus

automaticResponseUrl

ANS512

URL provided by the merchant and used by the payment server to automatically notify the merchant of the result of the transaction online.

automaticReverse

A5

Systematically reverses and rejects accepted authorisations.

Values: booleanIndicator

avsAddressResponseCode

AN1

Contains the result of the AVS ADDRESS check.

Values: avsResponseCode

avsPostcodeResponseCode

AN1

Contains the result of the AVS POSTCODE check.

Values: avsResponseCode

basket

ANS2048

Content of the customer's basket.

bankCode

AN11

Please see "bic".

bcacb3x

Container

Contains specific information on the CB3X means of payment from Floa Bank.

bcacb4x

Container

Contains specific information on the CB4X means of payment from Floa Bank.

bcaCup

Container

Contains specific information on the CUP Card means of payment from Floa Bank.

bic

AN11

Business Identifier Code (BIC) as described in ISO 9362. It identifies the institution code, its country and its location (on 8 characters), and the institution's branch (on 11 characters).

billingAddress

Container

Contains the billing address information for the buyer.

billingContact

Container

Contains the billing contact's information.

billingFirstDate

N8

First successful billing date for the customer address. For example, the merchant gives this information to allow the certification of an electronic signature.

birthCity

ANU50

Birthplace.

birthCountry

N3

Country of birth.

birthDate

N8

Date of birth.

birthPlaceCode

N1

Place of birth code filled by Franfinance in its own codification.

birthZipCode

AN10 (restricted String)

Postal code for the birth.

blockAmountModification

A5

Indicator to prohibit the modification of the field "amount to consume" on the payment page.

Values: booleanIndicator

businessName

ANU255

Business name.

bypass3DS

ANS20

Indicator used by the merchant to bypass the 3-D Secure procedure.

Values: bypass3DS

bypassCtrlList

ANS256

List of antifraud rules provided by the merchant to bypass current transaction rules.

Values: bypassCtrlList

bypassDcc

AN1

Indicator used by the merchant to bypass the dcc procedure.

Values: bypassDcc

bypassInfoList

ANS256

List of information provided by the merchant to bypass fraud information.

Values: bypassInfoList

bypassReceiptPage

A5

Flag indicating that WL Sipsmust not issue the ticket receipt. This action is at charge of the trader. At the end of the payment, the customer is directly redirected to the response url from the shop (normalReturnUrl).

Values: booleanIndicator

captureDay

N2

Deadline for settlement.

captureLimitDate

N8

Date from which the transaction will be sent for settlement. Beyond this date, the merchant can no longer validate or cancel the transaction.

captureLimitDateTime

ANS25

Date and time from which the transaction will be sent for settlement. Beyond this date, the merchant can no longer validate or cancel the transaction.

captureMode

ANS20

Payment collection method for the transaction.

Values: captureMode

cardAuthPolicy

Container

Authentication policy for card.

cardBrand

ANS20

Please see "paymentMeanBrand".

cardCorporateIndicator

A1

Indicates whether the card is an Enterprise / Commercial card or not.

Values: cardCorporateIndicator

cardCreditDebitIndicator

A1

Indicates if the card is a debit or credit card.

Values: cardCreditDebitIndicator

cardCSCPresence

ANS20

Indicator of presence of the visual cryptogram called CSC (Card Security Code).

Values: cardCSCPresence

cardCSCResultCode

AN2

Response code for the Card Security Code check returned in the authorisation response.

Values: cardCSCResultCode

cardCSCValue

N4

Visual card security code on the bank card transmitted in the authorisation request (CSC, Card Security Code, referred to as CVV for Visa, CVC for Mastercard and 4DBC for American Express).

cardData

Container

Contains specific information regarding a card

cardDataList

Composite list

CardData container list returned following a card information request (in case of card cobadged several occurrences may appear - example: CB / Visa card).

cardEffectiveDate

N6

Indicates wether the card has a validity start date.

cardEffectiveDateIndicator

A1

Indicator of existence of a card effective date (Y/N/Empty)

cardExpiryDate

N6

Please see "panExpiryDate".

cardIIN

N9

Issuer Identification Number (IIN).

cardInterchangeCategoryCode

AN2

Category code of the card taken into account during the interchange.

Values: cardInterchangeCategoryCode

cardNumber

N19/ANS128

Card number (format N19 unless the card number is a Token, and in this case, the format is ANS128).

cardProductCode

AN5

Product code of the card.

cardProductName

ANS70

Product name of the card.

cardProductProfile

A1

Profile code of the card.

Values: cardProductProfile

cardProductUsageCode

AN20

Nature of the product code of the card which defines its use in our codification.

cardProductUsageLabel

ANS50

Profile name of the card which is displayed on payment electronic ticket in accordance with MPADS requirements.

Values: cardProductUsageLabel

cardScheme

ANS20

Network name associated with the card.

Values: cardScheme

cardSeqNumber

N2

Card sequence number allocated by the issuer.

cardSeqNumberIndicator

AN1

Indicator of existence of an issue number

Values: cardSeqNumberIndicator

cavv

ANS28

Cardholder's authentication verification value communicated in the MPI during 3-D Secure payments.

cavvAlgorithm

N1

Algorithm indicator used to generate a CAVV communicated in the MPI during 3-D Secure payments.

Values: cavvAlgorithm

cetelem3x

Container

Contains dedicated data of a Cetelem 3xCB payment.

cetelem4x

Container

Contains dedicated data of a Cetelem 4xCB payment.

cetelemPrivateData

ANS400

Specific private data regarding the transaction exchanged between the merchant and Cetelem.

cetelemPrivateMerchantData

ANS400

Specific merchant data provided by the merchant to be sent to Cetelem.

challengeMode3DS

ANS20

Holder authentication level requested by the merchant.

Values: challengeMode3DS

changeDate

N8

Date of the last change made on the customer account at the merchant.

chargeAmount

N12

Amount of the surcharge of payment transaction, if applicable.

chargebackAcquirerReference

ANS20

Acquirer's chargeback reference.

chargebackAmount

N12

Chargeback amount.

chargebackDocumentRequestDate

N8

Date of the document request.

chargebackDocumentRequestReason

AN1

Reason for the document request.

chargebackReasonCode

AN8

Chargeback reason code as it is provided on the chargeback statement (MDI) by the acquirer.

chargebackSettlementDate

N8

Clearing date of the chargeback.

chargedBankAccount

AN11

Merchant account number to which the chargeback was charged.

chargedBankAdminCounter

AN5

Code for the Merchant's management branch to which the chargeback is charged.

chargedBankCode

N5

Merchant bank code to which the chargeback was charged.

chargedBankCounter

N5

Sort code for the Merchant's bank to which the chargeback was charged.

check3DS

A6

FORCE/BYPASS. Indicator to execute the 3-D Secure check for issuer wallet payment means (used by V.me and MasterPass). For V.me, by default, 3-D Secure check is deactivated. For masterPass, 3-D Secure check is activated

checkAVS

A5

Indicator (true/false) to execute the AVS check. By default, the control is deactivated.

Values: booleanIndicator

checkCSC

A6

FORCE/BYPASS. Indicator to execute the CSC check for issuer wallet payment means (used by V.me). For V.me, by default, CSC check is deactivated.

city

ANU50

City of the address.

cofidis3x

Container

Contains specific information on Cofidis 3xCB payment method.

cofidis4x

Container

Contains specific information on Cofidis 4xCB payment method.

cofidisDisplayCancelButton

AN4

Information displaying a "Cancel" button (or link) on the 3xCB payment pages hosted by Cofidis.

cofidisPrivateData

ANS256

Specific data exchanged between the merchant and Cofidis.

cofinoga

Container

Contains specific information on Cofinoga payment method.

cofinoga3xcb

Container

Contains specific information on Cofinoga 3xCB payment method.

company

ANU50

Company for the address.

complementaryCode

AN2

Additional response code from the WL Sips server returned in the response.

Values: complementaryCode

complementaryInfo

AN256

Additional information from the WL Sips server sent back in the response.

completionRedirectUrl

url

Optional URL for Bancontact mobile application that can be used as Merchant Callback URL for notifications. It is triggered by the Payer Mobile Payment Application once the Payer had reviewed the transaction results in its Mobile Payment Application.

contractNumber

ANS128

Contract number assigned by the acquirer to identify a merchant contract.

contractType

AN1

Acquirer contract type as it is provided on statement of chargeback by the acquirer.

country

A3

Country code for the address.

Values: countryList

creationDate

N8

Creation date.

With the container customerAccount, it is the date of creation of the customer account at the merchant which makes it possible to calculate the seniority of the account.

creditIndicator

AN1 (restricted String)

Credit indicator specifies the choice of payment by the holder or

creditorId

ANS35

Unique identifier of the creditor. For SEPA, the Creditor Identifier (CI) is required to send Direct Debit instructions.

cscType

AN5

Format of the CSC (Card Security Code) provided in the data cardCscValue

Values: cscType

currencyCode

N3

Currency code for the transaction. This code is ISO 4217 compatible.

Values: currencyCode

currentAmount

N12

Current transaction amount.

customer3DSTransactionDate

N8 (YYYYMMDD)

Date of a 3D Secure transaction successfuly realised for the customer. For example, the merchant gives this information to allow the certification of an electronic signature.

customerAccount

AN34

Account number of the customer either in national, or international or specific codification. The format is specified in the field customerBankAccountType (eg IBAN ...).

customerAccountHistoric

Container

Contains information from the customer's account at the merchant (date of creation, number of transactions in the last 24h, ...).

customerAccountId

ANS64

Additional information about the account optionally provided by the 3-D Secure Requestor.

customerAddress

Container

Contains the customer's address information.

customerANI

ANS10

Phone number that customer used to checkout captured automatically by the merchant.

customerANIInformationIdentifier

ANS2

Telephone company provided ANI Information Identifier associated with customerANI and it indicates call type.

customerBank

Container

Contains the customer's bank information.

customerBankAccountType

ANS20

Format of the customer bank code and account.

Values: customerBankAccountType

customerBankCode

AN11

Bank code of the customer either in national, or international or specific codification. The format is specified in the field customerBankAccountType (eg BIC ...).

customerBankName

ANS150

Bank name of the customer.

customerBillingNb

N3

Number of billing realised for the customer address. For example, the merchant gives this information to allow the certification of an electronic signature.

customerBrowserType

ANS60

Browser type used by the customer. Example: Mozilla, AOL Explorer 9.5, MSN IE 9, MSN IE 10, MSN IE 11, etc …

customerContact

Container

Contains the customer's information.

customerData

Container

Contains the customer's information.

customerDeliverySuccessFlag

A1

Successful delivery flag for the customer. For example, the merchant gives this information to allow the certification of an electronic signature.

Values: customerDeliverySuccessFlag

customerEmail

ANS128

Depreciated, replaced by "email" in the container customerContact.

customerHostName

ANS60

Name of server to which customer is connected. Example: PHX.QW.AOL.COM.

customerId

AN19

Customer identifier

customerIpAddress

NS19

Buyer's IP address.

customerLanguage

A2

Language of the user, used on the payment pages.

Values: customerLanguage

customerPhoneValidationMethod

ANS20

Method used to validate the customer phone number. For example, the merchant gives this information to allow the certification of an electronic signature.

Values: customerPhoneValidationMethod

customerRegistrationDateOnline

N8

Online registration date of the customer. For example, the merchant gives this information to allow the certification of an electronic signature.

customerRegistrationDateProxi

N8

On site (Point Of Sale) registration date of the customer. For example, the merchant gives this information to allow the certification of an electronic signature.

datesList

YYYYMMDD

List of the dates of occurrences for payment in instalments.

dccAmount

N12

Amount of the DCC transaction (include exchange rate), in card holder currency.

dccCurrencyCode

N3

Currency code of the card holder.

Values: currencyCode

dccExchangeRate

ANS10

DCC exchange rate used for the transaction.

dccProvider

ANS30

DCC provider name.

dccRateValidity

ANS25

Date/Time of validity of the DCC exchange rate.

dccResponseCode

N2

DCC response code of the transaction.

Values: dccResponseCode

dccStatus

N2

DCC status of the transaction.

Values: dccStatus

debtorName

ANU50

Full name of SDD mandate debtor (firstname and lastname of mandatary).

defaultRedirectUrl

url

Optional URL for Bancontact mobile application that can be used as Merchant Callback URL for notifications. It can be triggered if the transaction is not completed, or if the connection between the Mobile Payer Payment Application and its Transaction Manager Issuing is lost later during the transaction.

deliveryAddress

Container

Contains the delivery address information.

deliveryAddressCreationDate

N8

The date on which the last delivery address used by the merchant's account was reported in the transaction.

deliveryAddressStatus

ANS20

Status of the delivery address.

deliveryChargeAmount

N12

Total shipping costs for the order.

deliveryContact

Container

Contains the delivery contact's information.

deliveryData

Container

Contains the delivery information.

deliveryFirstDate

N8

First successful delivery date at the customer address. For example, the merchant gives this information to allow the certification of an electronic signature.

deliveryMethod

ANS20

Method chosen for delivery (standard, priority, …).

deliveryMode

ANS20

Mode of the delivery (Post Office, in a participating store, …).

deliveryOperator

ANS255

Name of the carrier ensuring the delivery.

deniedCardArea

AN10

Identifier of a predefined list of card countries refused by the merchant.

Values: areaList

deniedCardCountryList

ANS128

List of country codes for cards not authorised to make a payment

Values: countryList

deniedIpArea

ANS128

Name of a pre-established list of buyer IP country codes not authorised to make a payment.

Values: areaList

deniedIpCountryList

ANS128

List of buyer IP country codes not authorised to make a payment

Values: countryList

departureDate

N8

Departure date.

depositRefundIndicator

A1

Indicator of deposit refund. If the merchant suspects fraud, he can choose to refund or not the deposit.

Values: depositRefundIndicator

destinationAirport

ANS5

Destination airport.

directDebitCreationDate

N8

Creation date of direct debit.

directDebitStatus

ANS20

Status of direct debit.

Values: directDebitStatus

discountAmount

N12

Total amount of discounts associated with the order.

dueDate

N8

Please see "valueDate".

dupCustom

ANS127

Paypal Field left free for the merchant, taken into account when dupFlag is set to "true"

dupDesc

ANS127

Description of the reason for PayPal duplication, possible when dupFlag is set to "true". Shown to the Internet user on their PayPal account in the transaction details.

dupFlag

A5

Indicator allowing the PayPal transaction to be duplicated.

Values: booleanIndicator

dupType

ANS30

Paypal Duplication type. This optional information is taken into account when dupFlag is "true".

Values: dupType

eci

N2

Electric commerce indicator communicated in the MPI during 3-D Secure payments.

electronicDeliveryIndicator

A1

Specifies whether the delivery is in an electronic mode.

Values: booleanIndicator

elv

Container

Contains specific information on german ELV payment method (Elektronisches LastschriftVerfahren).

email

ANS128

Contact's email address.

errorFieldName

ANS50

Error field name of the incoming request.

estimatedDeliveryDate

N8

Estimated delivery date by the merchant.

estimatedDeliveryDelay

N3

Estimated delivery delay (in days) by the merchant.

evidenceAcquisitionDate

N8

Date when the customer has provided the proof to the merchant. For example, the merchant gives this information to allow the certification of an electronic signature.

evidenceNumber

ANS50

Number of the proof provided by the customer. For example, the merchant gives this information to allow the certification of an electronic signature.

evidenceType

ANS20

Type of proof provided by the customer. For example, the merchant gives this information to allow the certification of an electronic signature.

Values: evidenceType

exchangeAmount

N12

Counter value amount.

exchangeCurrencyCode

N3

Counter value currency code. This code is ISO 4217 compatible.

Values: currencyCode

exchangeUnpaidAmount

N12

Counter value chargeback amount.

expirationDate

ANS20

Expiry date of the payment request initiated by the merchant.

facilypay

Container

Information specific to Accord Oney FacilyPay (online credit) payment method.

fareBasis

ANS24

Fare Basis. Example: business class, economy class, …

feeAmount

N12

Amount of the payment acquisition commission.

feeCurrency

N3

Currency code for the commission. This code is ISO 4217 compatible.

Values: currencyCode

feesTransferNumber

ANS11

Reference of the acquiring debit fees.

feeType

ANS20

Sign of the commission on merchant's account.

Values: feeType

financialProduct

AN3

Financial product chosen by the buyer. To fill with "CLA".

firstname

ANU50

First name of the contact.

fraudData

Container

Contains the transaction's antifraud rules parameters, allowing the merchant to dynamically customise the rules registered in the merchant configuration.

fraudListElementType

ANS20

Feeding mode of the fraud card list.

Values: fraudListElementType

fraudListElementValue

ANS128

Depending on the fraudListElementType, this field refers to the fraud list used.

Below two examples of use cases:

fraudListElementType = TRANSACTION_ID

fraudListLevel

ANS20

Level / Color of the fraud list to be fed.

Values: fraudListLevel

fraudListReasonCode

AN3

The code of the reason why the element is added in the fraud list.

Values: fraudListReasonCode

fraudListType

ANS20

Type of list used for the Fraud check.

Values: fraudListType

fraudResponseCode

N2

Fraud response code.

fromMerchantId

AN15

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

fromTransactionAcceptor

ANS20

Acceptance platform used by the acceptor to process the original transaction during a duplication operation or a transaction completion to reference the authorisation.

fromTransactionReference

AN35

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

fromTransaction RemainingAmount

N12

Remaining amount of the mother transaction (the transaction from which the recycle operation is done)

fundTransferNumber

AN12

Transfer number assigned by the acquirer in order to identify a payment flow on the merchant account.

gender

A1

Gender of the contact, male (=M) or female (=F).

getTransDataResponseCode

N2

Response code of service getTransactionData.

Values: getTransDataResponseCode

giftCardAmount

N12

For prepaid or gift card purchase, the purchase amount total of prepaid or gift card(s) in major units. Example: gift card amount is USD 123.45.

giftCardCount

N1

For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

giftCardCurrencyCode

N3

For prepaid or gift card purchase, ISO 4217 threedigit currency code of the gift card.

Values: currencyCode

grossAmount

N12

Gross amount for the transaction paid.

guaranteeIndicator

A1

Transaction's guarantee level.

Values: guaranteeIndicator

guaranteeLimitDate

N8

Deadline for application of the payment guarantee.

hashAlgorithm1

ANS20

Cryptographic function used to calculate the hashPan.

Values: hashAlgorithm

hashAlgorithm2

ANS20

Please see "hashAlgorithm1".

hashPan1

AN128

Cryptographic PAN identifier, calculated by WL Sips.

hashPan2

AN128

Please see "hashPan1".

hashSalt1

AN32

Random value (called a seed) provided by the merchant to calculate the hashPan.

hashSalt2

AN32

Please see "hashSalt1".

holderAdditionalReference

ANS35

Additional reference of the holder that is communicated to the acquirer system or the issuer system in order to make some additional dedicated checks.

holderAddress

Container

Contains the payment mean holder's address information.

holderAddressCountry

A3

Country code for the payment mean holder's address.

Values: countryList

holderAuthentMethod

ANS20

Name of the method applied to authenticate a payment mean holder

Values: holderAuthentMethod

holderAuthentProgram

ANS20

Authentication programme

Values: holderAuthentProgram

holderAuthentProvider

AN1

Specifies the PSP that performed the authentication.

Values: holderAuthentProvider

holderAuthentRelegation

A1

Please see "holderAuthentRelegationCode".

This data is used by Sips Office for versions lower than 2.17.

holderAuthentRelegationCode

A1

Code indicating whether the issuer accepts or refuses the transfer of responsibility.

Values: holderAutfhentRelegationCode

holderAuthentResponseCode

A2

Response code of the authentication process.

Values: holderAuthentResponseCode

holderAuthentStatus

ANS20

Result of the authentication process.

Values: holderAuthentStatus

holderAuthentType

ANS25

Cardholder authentication type applied by the issuer of the card. Field valued in 3-D Secure v2.

Values: holderAuthentType

holderContact

Container

Contains contact details of the payment mean holder.

holderData

Container

Contains the payment mean holder's information.

iban

AN34

International Bank Account Number (IBAN) identifying a bank account in conformity with ISO 13616.

ignoreAddressCheckResult

A5

Indicator to ignore the ADDRESS check result.

Values: booleanIndicator

ignoreCSCCheckResult

A5

Indicator to ignore the CSC check result.

Values: booleanIndicator

ignorePostcodeCheckResult

A5

Indicator to ignore the POSTCODE check result.

Values: booleanIndicator

inAppResponseCode

N2

WL Sips server response code for Sips In-App operation.

Values: inAppResponseCode

initialSchemeTransactionIdentifier

instalmentData

Container

Contains the information making it possible to make a payment in instalments.

interchangeFee

N12

Amount of the interchange fees (exchanged between the acquirer and the issuer) in the transaction's currency.

interfaceVersion

AN20

Version value and number of the interface used.

Values: interfaceVersion

intermediateServiceProviderId

AN30

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

invoiceId

AN127

Order number, same as the orderId but with PayPal, it must be unique. Mandatory in order to use PayPal.

invoiceReference

N30

Invoice reference.

issuerCode

AN6

Issuer code of the card

issuerCountryCode

A3

Country code of the card issuer

Values: countryList

issuerEnrollementIndicator

N2

Indicator of issuer enrollment to authentication programme

Values: issuerEnrollementIndicator

issuerName

ANS250

Issuer name of the card

issuerRegionCode

AN1

region code of the card issuer

Values: regionList

issuerWalletAuthPolicy

Container

Authentication policy for wallet.

issuerWallettId

ANS50 (Restricted String)

Identifier provided by issuer wallet to identify a payment mean.

issuerWalletInformation

ANS255

Information given by the wallet provider intended for the merchant in response to a transaction creation request.

issuerWalletType

ANS20

Issuer wallet type.

Values: issuerWalletType

keyVersion

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

landingPage

A5

Indicator allowing the merchant to hide the subscription form on PayPal pages. "false" is the default value.

Values: booleanIndicator

lastMerchantOperationDateTime

ANS25

Date and time of the last operation created on this transaction by the merchant.

lastMerchantOperationName

ANS30

Name of the last operation created on this transaction by the merchant.

Values: lastMerchantOperationName

lastname

ANU50

Last name of the contact.

lastOperationDateTime

ANS25

Date and time of the last operation applied to the transaction diagnosed.

lastOperationName

ANS30

Name of the last operation completed on a transaction.

Values: lastOperationName

lastRecoveryIndicator

AN5

This indicator specifies that the operation is the last settlement of this transaction.

Values: booleanIndicator

legalId

AN14

Legal business identifier (SIRET in France). This field is applicable for merchant or customer (please see fields Contact).

maidenName

ANU50

Maiden name.

mainProduct

ANU255

The most expensive product in the shopping cart.

mainProductCategory

ANU50

Category to which bel;ongs the most expensive product in the basket. Example: Appliances.

mandate

Container

All information characterizing a mandate of the merchant.

mandateAuthentMethod

ANS20

Type of signature used for the creation of the mandate.

Values: mandateAuthentMethod

mandateCertificationType

ANS20

Mandate signature certification type.

Values: mandateCertificationType

mandateCreationDate

N8

Creation date of mandate.

mandateId

AN35

Mandate number.

mandateLastUpdateDate

N8

Last updated date of mandate.

mandateList

Composite list

List of the merchant mandates.

mandatePdf

ANS10240

Pdf of mandate encoded in base64.

mandateResponseCode

N2

Response code returned by the mandate management service.

Values: mandateResponseCode

mandateSecureReference

ANS10

Debtor identifier by the SSP (Score and Secure Payment) regarding a SDD payment.

mandateSignatureDate

N8

Signature date of mandate.

mandateStatus

ANS30

Mandate status.

Values: mandateStatus

mandateUsage

ANS20

Type of mandate used.

Values: mandateUsage

manualErrorResponseInitPOST

ANS512

Merchant's URL for the return to the shop in case of initialization error of the transaction.

maskedPan

NS19

Masked Primary Account Number. In the case of wallets, masked PAN of the payment mean registered in the wallet.

merchantCseKeyValue

ANS1024

Value of the CSE (Client Side Enryption) of the cardholder's personal data encryption system.

merchantCseKeyVersion

N3

Version number of the CSE (Client Side Encryption) key.

merchantCustomerAuthentData

ANS255

Future Use.

merchantCustomerAuthentDateTime

ANS25

Date and time in UTC of the cardholder authentication.

merchantCustomerAuthentMethod

ANS20

Authentication method used by the merchant to authenticate the buyer on the point of sale before making the payment.

Values: merchantCustomerAuthentMethod

merchantExternalId

ANS35

External identifier provided by the merchant for its own use.

merchantId

N15

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

merchantLegalId

AN14

Legal identifier of the merchant (local codification specific to each country).

merchantName

AN25

Merchant name (equivalent to the Merchant name registered during the Shop enrollment).

If indicated in the payment request, allows to change the name displayed on the 3-D Secure authentication page.

merchantReturnUrl

url

Merchant Return Url (used for a Sips Office payment request with redirection).

merchantSessionId

AN256

Merchant's session number. Allows consolidation between requests and responses.

merchantSessionToken

ANS1024

Merchant session token that contains the context of information for the Hosted Fields session.

merchantToken

ANS128

PAN token in the format requested by the merchant.

merchantTokenOrigin

ANS20

Source of the calculation for the merchant's tokenPAN.

Values: merchantTokenOrigin

merchantTransactionDateTime

ANS25

Date and time of the transaction, set by the merchant at the merchant's local time (in the merchant's time zone)

merchantUrl

AN2048

Merchant web site URL.

merchantWalletId

AN21

Customer's Wallet identifier.

messageFunction

ANS20

Role (function) of the request sent to the acquirer. For example indicates if the request relates to an authorisation request or an authorisation reversal.

Values: messageFunction

messageVersion

ANS20

Parameters version of redirection (used for Sips Office with redirection).

mobile

ANS30

Mobile phone number for the contact.

mobile (paypal)

A5

Indicator allowing the merchant to specify if the terminal used by the Internet user is a mobile. "false" is the default value.

Values: booleanIndicator

nameDeliveryCustomerMatchIndicator

A5

Specifies whether the customer and the delivery names are the same.

Values: booleanIndicator

nameMatch

A5

Matching between the name of the merchant's account owner and the delivery name. For example: 1 if the account name = the delivery name. By default this data is not filled.

Values: booleanIndicator

nationalityCountry

A3

Country of nationality.

netAmount

N12

Net amount (amount credited to the merchant's account).

networkCode

A1

VCR (Visa Claims Resolution) network code of an international unpayment.

Values : networkCode

newAmount

N12

Amount of the transaction updated after checkout operation.

newPassword

AN10

Customer's new password.

newStatus

ANS20

Status of the transaction updated after a checkout operation. The status of a transaction is described by different keywords which change during the operations it undergoes.

Values: transactionStatus

normalReturnUrl

ANS512

Merchant's URL for the return to the shop.

number

N2

Number of occurrences for payment in instalments.

numberOfAirlineCarriers

N2

Number of airline carriers.

numberOfAttemptsAddCard24Hours

N2

Number of distinct cards used by the merchant's account in the last 24 hours.

numberOfCapturedTransaction

N2

Number of transactions captured over the last period. This period is defined by the acquirer of the means of payment. This data provided by the merchant is used for the 3-D Secure authentication check.

numberOfPassengers

N3

Number of passengers.

numberOfPurchase180Days

N4

Number of purchases made on the customer's account via the merchant site over the last six months (last 180 days).

numberOfRefusedTransaction

N2

Number of transactions refused over the last period. This period is defined by the acquirer of the means of payment. This data provided by the merchant is used for the 3-D Secure authentication check.

numberOfRoutingCities

N2

Number of routing cities.

numberOfTransaction24Hours

N3

Number of abandoned or successful transactions in the last 24 hours on the customer account.

numberOfTransactionYear

N4

Number of accepted or abandoned transactions in the last year on the merchant's customer account.

officeBatchResponseCode

N2

officeBatchResponseCode completes the result of the processing of a payment request handled by which would be rejected (classic reject responseCode) and contains the field of the payment request that is in error.

Valeurs : officeBatchResponseCode

oney34x

Container

Specific information about the payment means Oney payment in three times or payment in four times.

operationAmount

N12

Amount of the operation (refund, cancellation, validation etc).

operationDateTime

ANS25

Date and time calculated by WL Sips on which the transaction has been completed.

operationName

ANS30

Name of the operation completed on a transaction.

Values: operationName

operationOrigin

AN20

Origin of an operation (for example: name of the program), set by the sender of the request (merchant or WL Sips).

operationSequence

N4

Sequence number of the operation in the transaction's life cycle.

operationType

ANS20

Type of operation (DEBIT or CREDIT).

Values: transactionServiceType

orderChannel

ANS20

Order channel used (Internet, Telephone, Post, Fax etc), Internet is the default value.

Values: orderChannel

orderContext

Container

Contains specific information regarding the order context

orderDescription

ANS127

Order description of purchased items.

orderId

ANS32

Order number associated with the payment transaction.

originAirport

ANS5

Origin airport.

originAmount

N12

Amount of the transaction during its creation.

outerRedirectionUrl

URL

Redirection URL to an outer payment application (eg BCMC mobile application)

pageCustomizationCode

AN5

Code provided by Franfinance, allowing to customize the screens in the colors of the partner.

pan

N19 or ANS35

PAN (Primary Account Number).

panCheckAlgorithm

A1

Control algorithm applied on the PAN (L/V/N/Empty)

Values: panCheckAlgorithm

panData

Container

It contains the PAN data to be converted into token PAN.

panDataList

Composite list

List of PAN to be converted into token PAN.

panEntryMode

AN20 (restricted values)

Primary Account Number reading mode. For example, for a OneClick payment, indicates that the PAN was retrieved from the WL Sips wallet.

Values: panEntryMode

panExpiryDate

N6

Expiry date of an instrument associated with a Primary Account Number.

panId

N5

Sequence number of PAN in the list. This number is the same between the request and the response

panLengthMax

N2

Maximum length of the PAN

panLengthMin

N2

Minimal length of the PAN

panType

ANS20

Format of the Primary Account Number provided in the data cardNumber

Values: panType

paReqMessage

ANS10240

Payer Authentication Request (PAReq) that the merchant must transmit to ACS for 3-D Secure authentication.

paResMessage

ANS10240

Payer Authentication Response (PARes) generated by the ACS for the cardholder authentication response and transmitted to the ThreedSecureService service.

passbe

Container

Contains specific information on Passbe payment method (Card PASS in Belgium).

passengerName

ANS40

Passenger name.

password

AN10

Password.

passwordChangeDate

N8

Date of last change of password of the customer account at the merchant.

payerBusiness

ANS127

Payer's business name.

payerId

AN13

Unique buyer account identification in the issuer of payment.

payerStatus

AN10

Status of payer. For exemple, Paypal may return verified, unverified.

payerSuffix

ANS12

Suffix of payer.

paymentAttemptNumber

N2

Number of payment attempts made by the buyer.

paymentMeanAlias

ANU20

Payment mean alias defined by the Buyer and used in the Buyer's wallet

paymentMeanBrand

ANS20

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

Values: paymentMeanBrand-type

paymentMeanBrandList

ANS128

List of payment methods accepted for a transaction.

Values: paymentMeanBrand-type

paymentMeanBrand SelectionMode

ANS20

Brand application selection method sent to the acquirer.

Values: paymentMeanBrandSelectionMode

paymentMeanBrand SelectionStatus

ANS20

Status of the processing of the brand application selection on paypage.

Values: paymentMeanBrandSelectionStatus

paymentMeanCustomerId

ANS21

Client's reference used for the payment method. Currently, this reference is used only for Presto.

paymentMeanData

Container

Contains specific information regarding the payment method used by the buyer.

paymentMeanDataProvider

AN20

Name of data provider of the payment mean.

Values: paymentMeanDataProvider

paymentMeanId

N6

Please see "paymentMeanSequence".

paymentMeanInfoResponseCode

N2

Response code of a payment mean information request

Values: paymentMeanInfo ResponseCode

paymentMeanSequence

N6

Payment mean rank in the Buyer's wallet.

paymentMeanTradeOption

Container

Trade terms of the payment method and the trade partner.

paymentMeanTradeOptionList

Composite list

List of trade terms per payment method and trade partner.

paymentMeanTradingName

ANS50

Trading name of the partner merchant accepting with the payment method. For example, for a privative card, indicates the brand to which the card is "cobranded".

paymentMeanType

ANS20

Payment method type (card, transfer, withdrawal, etc). It groups together a set of paymentMeanBrand.

Values: paymentMeanBrand-type

paymentPattern

ANS20

Type of payment (per operation, 1st recurring payment etc).

Values: paymentPattern

paymentProviderSessionId

AN255

Session ID calculated during initialization of a Sips In-App payment or via a Wallet external (e.g. Paylib) with Sips Office.

paymentStatus

ANS20

Indicates whether the Sips transaction has been reconciled with one acquirer movement of from RGI and MPI .the acquisition of payments (statement from your acquirer).

Values: paymentStatus

paymentToken

Hosted Fields payment token to be sent when making calls to Sips Office and allowing you to find card payment information for classic or 3-D Secure payment, by wallet or not.

paypageData

Container

Contains the parameters for the payment pages, allowing the merchant to dynamically customise the options on payment pages.

paypal

Container

Contains specific information on PayPal payment method.

pbaRemittanceNumber

AN12

See remittanceNumber.

phone

NS30

Telephone number for the contact.

positionOccupied

ANS150

Position occupied.

posNb

N7

Point of sale number.

postBox

ANU50

Post box for the address.

preAuthenticationColor

ANS30

Colour associated with the result of pre-authentication antifraud rules. Used to trigger the authentication level for a given transaction.

Values: scoreColor

preAuthenticationInfo

ANS512

Detailed result of each rule executed during the antifraud controls in pre-authentication. ERROR is displayed if an error is generated during the check sequence.

Values: fraudData

preAuthenticationProfile

ANS50

Name of the applied pre-authentication profile.

Values: fraudData

preAuthenticationProfileValue

ANS50

Identifier of the antifraud profile applied during the pre-authentication step. Unlike the profile name, the unique identifier takes into account the dynamic override and the bypassing of the antifraud rules. With this identifier you can retrieve all executed antifraud rules of a transaction and their setup and could be used in case of dispute.

Values: fraudData

preAuthenticationRuleResultList

Composite list

List containing the result of each executed antifraud rules in pre-authentication step.

preAuthenticationThreshold

NS10

Thresholds to determine the risk level of a transaction in pre-authentication step.

Values: fraudData

preAuthenticationValue

NS10

Antifraud result of the pre-authentication check.

Values: fraudData

preAuthorisationProfile

ANS50

Name of the applied pre-authorisation profile.

Values: fraudData

preAuthorisationProfileValue

ANS50

Unique identifier of the antifraud profile applied for a transaction in pre-authorisation step. Contrary to the profile name, the unique identifier takes into account the dynamic override and the bypassing of the antifraud rules. This identifier allows to retrieve all executed antifraud rules of a transaction and their setup and could be used in case of dispute.

Values: fraudData

preAuthorisationRuleResultList

Composite list

List containing the result of each executed antifraud rules in pre-authorisation step.

Values: fraudData

preScoreValue

AN10

Value of the score Pre-authentication computed by the Fraud engine in Business Score mode.

presto

Container

Contains specific information on Presto Plus payment method.

prestoCardType

AN1

Card type used for Presto Plus if the buyer has chosen a financial product with opening revolving card account.

processingDateTime

ANS25

MPI processing timestamp (XMLGregorianCalendar).

productAvailabilityDate

N8

Availability date of the purchased product.

productAvailabilityIndicator

A5

Availability of the goods.

Values: booleanIndicator

productCategory

ANS20

Category of the ordered product (for example digital).

productCode

ANS64

Code of the ordered product.

productDescription

ANU255

Detailed description of the ordered product.

productName

ANU255

Name of the ordered product.

productQuantity

N12

Quantity of products in the shopping cart.

productSKU

ANS255

Merchant’s product identifier code, sent back in the response without modification.

productTaxCategory

AN1

Future Use.

productTaxRate

ANS10

Tax rate for the product (eg. 0,1999).

productUnitAmount

N12

Unit amount of the product. The amount must be transmitted in the smallest unit of currency.

productUnitTaxAmount

N12

Monetary value of the tax for the product (unit). The amount must be transmitted in the smallest unit of currency.

pspData

ANS255

Future use.

publicKeyValue

ANS16

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

publicKeyVersion

ANS20

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

receiverType

ANS1

Good or service receiver’s type (company or private individual)

recurringResponseCode

N1

Additional information about a recurring payment decline response

Values: recurringResponseCode

redirectionData

ANS10240

In case of 3-D Secure payment, contains the context of the transaction retrieved from the cardCheckEnrollment method.

redirectionStatusCode

N2

Response code returned by WL Sips when redirecting (e.g. redirecting to the ACS, to WL Sips server...). Indicates whether redirecting is possible or not.

Values: redirectionStatusCode

redirectionStatusMessage

ANS50

Additional information that is returned with redirectionStatusCode.

redirectionTimer

N3

Beyond this period, at the end of the payment process on the Franfinance page, the user will be automatically redirected to the merchant site. It must be less than 300 seconds.seconds.

redirectionUrl

URL

In case of an enrollment check, contains the redirection URL to the ACS required for the cardholder authentication.

redirectionVersion

AN20 (restricted String)

Version of the redirection message.

refundReason

ANS20

Merchant reason of refund.

remainingAmount

N12

Amount available to be recycled

remittanceDateTime

ANS19

Please see "settlementDateTime".

remittanceNumber

ANS35

Collection number defined by WL Sips.

reorderProductIndicator

A5

Specifies whether the product has been yet ordered.

Values: booleanIndicator

requestDateTime

ANS25

Date and Time (UTC) at which the merchant has submitted the request to the WL Sips server.

reservationCode

ANS15

Reservation code.

responseCode

N2

WL Sips server response code.

Values: responseCode

responseEncoding

AN10

Encoding type of the response expected by the merchant.

Values: responseEncoding

responseKeyVersion

N10

Identifier of the merchant's secret key used to calculate the imprint of the response.

responsePanData

Container

Response returned during the PAN conversion.

responsePanDataList

Composite list

List of responses returned during the PAN conversion response.

responseTokenPanData

Container

Responses returned during the PAN conversion.

responseTokenPanDataList

Composite list

List of responses returned during the PAN conversion.

returnContext

ANS255

Context of a buyer's order.

Attention : the following characters "|", "«", "»", and «"» are forbidden in this field. If they are used, they will be replaced by blanks.

riskManagementCustomData

Container

Merchant privative information transmitted by the a Business Score scoring system. To know the use of this data, please contact your contact at the the Business Score scoring system.

riskManagementCustomDataList

Composite list

List of merchant privative information transmitted by the a Business Score scoring system.

riskManagementCustomSequence

N3

Sequence number of the merchant privative data transmitted to the external scoring manager. To know the use of this data, please contact your contact at the the Business Score scoring system.

riskManagementCustomValue

ANU255

Value of the merchant privative data transmitted to the external scoring manager. To know the use of this data, please contact your contact at the the Business Score scoring system.

riskManagementDynamicParam

ANS50

Parameter regarding the antifraud rule that is to be dynamically overwritten.

Values: riskManagementDynamicParam

riskManagementDynamicSetting

Container

Parameters of the Setting information related to the antifraud rule to be dynamically overwritten.

riskManagementDynamic SettingList

Composite list

List of parameters of th setting information related to the antifraud rules to be dynamically overwritten.

riskManagementDynamicValue

ANS255

New parameter value regarding to the antifraud rule to be dynamically overwritten.

Values: fraudData

riskyMandate

A5

As part of option SDD Safe Debit, it indicates whether the SSP (Score and Secure Payment) evaluates that the SDD mandate may involve a risk.

Valeurs : riskyMandate

routingCityList

ANS59

Routing city list.

ruleCode

AN2

Identifier of antifraud rule.

Values: fraudData

ruleDetailedInfo

ANS255

Detailed information returned once the antifraud rule executed. For example, for card country rule, the country of the card is returned.

Values: fraudData

ruleResult

Container

Detailed result of the antifraud rule.

Values: fraudData

ruleResultIndicator

AN3

Execution indicator of the antifraud rule.

Values: fraudData

ruleSetting

A1

Setting up mode of the antifraud rule parameters.

Values: fraudData

ruleType

A2

Type of antifraud rule.

Values: fraudData

ruleWeight

AN2

Weighting of the antifraud rule.

Values: fraudData

s10FromTransactionId

N6

Alternative identifier for the original transaction during a duplication and recycle operation (to be compliant with WL Sips 1.0).

s10FromTransactionIdDate

N8

Date the original transaction was processed on the WL Sips server (expressed in the WL Sips server time zone).

s10FromTransactionReference

Container

Contains the identification of the original transaction (to be compliant with WL Sips 1.0).

s10TransactionId

N6

The merchant can choose between transactionId and transactionReference (by default) to identify his transactions.

s10TransactionIdDate

N8

Date of the transaction (expressed in the WL Sips server time zone).

s10TransactionIdsList

N6

List of alternative identifiers for the transaction of occurrences for payment in instalments, to be compliant with WL Sips 1.0.

As part of payment in several times, it is the list of due dates of the payment in instalments.

s10TransactionReference

Container

Contains the identification of the transaction (to be compliant with WL Sips 1.0).

Contains the data pair (s10TransactionId, s10TransactionIdDAte) which ensures the uniqueness of the transaction 1.0.

schemeTransactionIdentifier

AN56

Unique reference of the transaction calculated by the SAE (Authorisation server of the issuer) and returned in ther authorisation response.

It allows to chain a MIT (Merchant Initiating Transaction) to a origin CIT (Customer Initiating Transaction)(Future use via the field initialSchemeTransactionIdentifier).

scoreColor

ANS30

Colour associated with the score. Used to give a comparison between the antifraud rules applied on a payment request.

The Business Score module assigns a score to each transaction qohich indicates the degree of risk you take if you accept the transaction. A color is also associated with this score through the scoreColor field.

Values: scoreColor

scoreInfo

ANS512

Return of the antifraud rule applied after the score is calculated, or ERROR if an error is generated during the check sequence.

The Business Score module assigns a score to each transaction qohich indicates the degree of risk you take if you accept the transaction. A color is also associated with this score through the scoreColor field.

scoreProfile

ANS50

Name associated with the profile used to calculate the transaction score.

The Business Score module assigns a score to each transaction qohich indicates the degree of risk you take if you accept the transaction. A color is also associated with this score through the scoreColor field.

scoreThreshold

ANS10

Thresholds to determine the risk level of a transaction in pre-authorisation step.

The Business Score module assigns a score to each transaction qohich indicates the degree of risk you take if you accept the transaction. A color is also associated with this score through the scoreColor field.

scoreValue

ANS10

Relative number representing the transaction score. Value of the score Pre-authorization computed by the Fraud engine in Business Score mode.

sdd

Container

Contains specific information on SDD payment method.

sddMandateId

AN35

Please see "mandateId".

sdkOperationName

ANS30

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

Values: sdkOperationName

sdkUrl

url

Url of the Hosted Fields SDK.

sdkVersion

ANS20

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

seal

ANS128

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

sealAlgorithm

ANS20

Algorithm applied to calculate the seal encryption.

Values: sealAlgorithm

secretKey

ANS1024

Secret key provided during merchant registration and retrieved via the Sips Download extranet. Secret key use UTF-8 characters set.

secureReference

AN10

as parto of SDD option Safe Debit, reference of the secure transaction returned by the SSP (Score & Secure Payment).

securityIndicator

N2

Transaction's security level.

Values: securityIndicator

settlementArchivingReference

ANS50

Specific data provided by the merchant and transmitted to the acquirer to process remittance. To use this data, please contact WL Sips.

settlementDatetime

ANS19

Date and time of payment collection.

settlementMerchantSpecificData

settlementMode

ANS20

Settlement mode chosen by the buyer. The values of this field should be acquirer's native codes. Any convertion is done by WL Sips.

settlementModeComplement

AN4

Further information on the settlement mode chosen by the buyer.

settlementModeList

Composite list

List of settlement mode allowed by the merchant. The values of this field should be acquirer's native codes. Any convertion is done by WL Sips.

settlementModeVersion

N3

Version of the settlement mode defined by the merchant.

shoppingCartDetail

Container

Information specific to the basket.

shoppingCartItem

Container

Information specific to an item of the basket.

shoppingCartItemList

Composite list

List of items in the basket.

shoppingCartTotalAmount

N12

Total amount of all products in the basket. This amount includes taxes but doesn't include any charges, fees and discounts.

shoppingCartTotalQuantity

N12

Total quantity of all products in the basket.

shoppingCartTotalTaxAmount

N12

Total amount of taxes in the basket.

sofinco

Container

Information specific to Sofinco card payment method.

sourceAmount

N12

Gross transaction amount.

state

ANU30

Country/region of the address.

statementReference

AN100

Reference provided by the merchant which is sent in the payment collection flow. This reference appears on the account statements of the cardholder.

street

ANU50

Name of the street of the address.

streetNumber

AN10

Number of the street of the address.

subMerchantAddress

Container

Contains address information of a merchant of the Payment Facilitator in the context of Collecting offer or a Marketplace offer.

subMerchantCategoryCode

A4

MCC Code of the vendor at the Payment Facilitator in a context of Collecting offer or a Marketplace offer.

subMerchantContractNumber

AN20

Merchant contract number of the Payment Facilitator in the context of Collecting offer or a Marketplace offer (only used for Cetelem).

subMerchantId

AN15

Merchant identifier of the Payment Facilitator in the context of Collecting offer or a Marketplace offer.

subMerchantLegalId

AN14

Legal identifier of vendor as merchant of the Payment Facilitator, expressed in the legal codification specific to each country.

subMerchantName

ANU50

Name of the merchant of the Payment Facilitator in the context of Collecting offer or a Marketplace offer.

subMerchantShortName

ANS15

Short name of the merchant of the Payment Facilitator in the context of Collecting offer or a Marketplace offer.

suspiciousActivityIndicator

A5

Specifies whether a suspicious activity is detected on customer account in the merchant's website.

Values: booleanIndicator

templateName

AN32

Name of the file corresponding to the style sheet (name of the zip file) used to personalize the payment pages.

testEnvironment

AN64

Choice of the testing environment of Franfinance.

threeD

Container

Contains cardholder's 3-D Secure authentication information.

threeDV2

Container

Contains cardholder's 3-D Secure v2 authentication information.

threeDHolderAuthentStatus

Please see "holderAuthentStatus".

title

A4

Title of the contact.

token

ANS20

Payor's token used for a payment Paypal.

tokenPan

AN35

Unique identifier for a PAN returned by the WL Sips server via the AWL token server in a merchant-oriented format (the format is a parameter in the merchant's configuration).

tokenPanData

Container

Token PAN to be converted into PAN.

tokenPanDataList

Composite list

List of token PAN to be converted into PAN.

tokenPanId

N5

Sequence number of PAN in the list. It is the same sequence number as the one in panDataList request.

tokenResponseCode

N2

Response code of each PAN to token conversion.

Values: tokenResponseCode

transactionActors

A4

Indicates the players in the transaction.

Values: transactionActors

transactionContextData

AN 10240

Transaction identification information (merchantId, transactionReference, interfaceVersion) ciphered by means of an internal key.

transactionContextVersion

ANS20

Version associated with the field transactionContextData

transactionDateTime

ANS25

Date and time the transaction was processed on the WL Sips server. (expressed in the WL Sips server time zone)

transactionIndicator

A3

Indicates whether the transaction was initiated by the merchant (MIT) or the customer (CIT).

Valeurs : transactionIndicator

transactionLink

ANS20

Type of link existing between the transaction and the original transaction.

Values: transactionLink

transactionOrigin

AN20

Origin of a transaction (for example: name of the programme), set by the merchant. Exemple: "Website A v1.32".

transactionPlatform

ANS12

Platform where the transaction has been executed.

Values: transactionPlatform

transactionReference

AN35

The merchant can choose of referencing his transactions by a transactionId or a transactionReference.

transactionReferencesList

AN35

List of references for the transaction of occurrences for payment in instalments.

transactionServiceType

ANS20

Direction of the transaction from the point of view of customer.

Values: transactionServiceType

transactionStatus

ANS20

Status of the transaction during the diagnostic.

Values: transactionStatus

travelContext

Container

Contains specific information regarding the travel.

txStatus

A1

Result of the authentication communicated in the MPI during 3-D Secure payments.

Values: txStatus

unEuroCom

Container

Contains specific information on Cofidis Pay 5x10x20x payment method.

validationIndicator

A1

Indicator allowing to accept a challenge and to validate the transaction simultaneously in the case of an alert for the Business Score fraud module (scoreColor = orange).

Values: validationIndicator

valueDate

N8

Payment value date

velocityElementType

AN50

Velocity element type.

Values: velocityElementType

velocityElementValue

AN256

Value of the velocity control element (example: IP address for IP velocity control).

velocityMaxNbTransaction

N10

Maximum transaction number authorized for the velocity rule requested.

velocityMaxTotalAmount

N12

Maximum transactions cumulated amount authorized for the velocity rule requested.

velocityMaxTransactionAmount

N12

Maximum transaction amount of the transaction authorized for the velocity rule requested.

velocityNbTransaction

N10

Transaction number processed during the period.

velocityPeriod

N4

Period during which the velocity is requested.

velocityProfileName

ANS50

Period, number of days, during which velocity information are requested.

velocityProfilePeriod

N10

Period, number of days, during which velocity rule is applied.

velocityTotalAmount

N12

Cumulated transaction amount realized during the requested period for the velocity rule.

virtualCardIndicator

A1

Indicates whether the card is a virtual card

Valeurs : virtualCardIndicator

visaCheckout

Container

Contains specific information on Visa Checkout.

visaCheckoutCallId

AN48

VCO CallId as defined by Visa.

walletActionDateTime

ANS25

Date and time of the action on the wallet, in WL Sips system at the merchant's local time (in the merchant's time zone)

walletActionNameList

ANS128

List of actions expected and limited by the merchant. Only the actions mentioned in this list will be allowed in the session of walletPage.

Values: walletActionNameList

walletCreationDateTime

ANS25

Date and time of the payment mean enrollment, in WL Sips system at the merchant's local time (in the merchant's time zone)

walletLastActionDateTime

ANS25

Date and time of the last action on the wallet, in WL Sips system at the merchant's local time (in the merchant's time zone)

walletPaymentMeanAlias

Please see "paymentMeanAlias".

walletPaymentMeanData

Container

Contains specific information regarding the payment mean registered in the wallet.

walletPaymentMeanDataList

Composite list

List, contains specific information regarding the payment mean registered in the wallet.

walletResponseCode

N2

WL Sips server response code for wallet Management.

Values: walletResponseCode

walletType

ANS20

Wallet Type.

Values: walletType

workphone

ANS30

Holder's business phone number.

xid

ANS28

Unique transaction ID (generated by the MPI) presented in all 3-D Secure messages and communicated in the MPI during 3-D Secure payments.

zipCode

AN10 (restricted String)

Postal code for the address.