Data Storage Parameters

Request Parameters

To initialize the QENTA Data Storage you have to set all required parameters to their corresponding values you need within your online shop. If one or more of these required parameters are missing you’ll get an error message.

Table 1. Initialization of QENTA Data Storage
Parameter Data type Description

customerId

Alphanumeric, fixed 7

Unique ID of merchant.

orderIdent

Alphanumeric

Unique reference to the order of your consumer.

returnUrl

Alphanumeric

Return URL for outdated browsers.

language

Alphabetic, fixed 2.

Language for returned texts and error messages.

requestFingerprint

Alphanumeric, 128.

Computed fingerprint of the parameter values and the secret.

Table 2. Credit Card, Mail Order and Telephone Order, and MaestroSecureCode
Parameter Data type Description

pan

Numeric, length of 13 to 19

Credit card number.

expirationMonth

Numeric, fixed 2

Expiration month of credit card.

expirationYear

Numeric, fixed 2

Expiration year of credit card.

Table 3. SEPA Direct Debit
Parameter Data type Description

accountOwner

Alphanumeric with special characters.

Name of owner of account.

bankAccountIban

Alphanumeric, up to 34 characters.

IBAN of account.

bankBic

Alphanumeric, up to 12 characters.

BIC of bank. Required only for Hobex

Table 4. Reading Stored Payment Data from QENTA Data Storage
Parameter Data type Short description

customerId

Alphanumeric, fixed 7

Unique ID of merchant.

storageId

Alphanumeric, fixed 32

Unique ID of Data Storage.

requestFingerprint

Alphanumeric, fixed 128

Computed fingerprint of the parameter values and the secret.

Table 5. Initialization of QENTA Data Storage
Parameter Data type Description

shopId

Alphanumeric with a variable length of 16

Unique ID of your online shop.

javascriptScriptVersion

Alphanumeric, fixed 4 characters

The value pci3 must be set to allow the input of credit card-related data in the displayed iframe.

Table 6. Credit Card, Mail Order and Telephone Order, and MaestroSecureCode.
Parameter Data type Description

cardholdername

Alphanumeric, up to 30.

Name of owner of a credit card.

cardverifycode

Numeric, of 1 to 4.

Verification code of a credit card.

issueMonth

Numeric, fixed 2.

Issuing month of a credit card.

issueYear

Numeric, fixed 2.

Issuing year of a credit card.

issueNumber

Numeric, of 1 to 3.

Issuing number of a credit card.

Table 7. SEPA Direct Debit
Parameter Data type Description

bankName

Alphanumeric with special characters.

Name of the bank.

Table 8. Reading Stored Payment Data from QENTA Data Storage
Parameter Data type Short description

shopId

Alphanumeric, 16

Unique ID of your online shop.

Table 9. PCI DSS SAQ A Compliance
Parameter Data type Description

iframeCssUrl

URL

URL to a CSS file on your server to perform customizations of the iframe input fields.

creditcardPanPlaceholder

Alphanumeric, 32 characters

Placeholder text for the credit card number field.

creditcardCvcPlaceholder

Alphanumeri, 32 characters

Placeholder text for the credit card verification number field.

creditcardCardholderNamePlaceholder

Alphanumeric, 32 characters

Placeholder text for the credit cardholder field.

creditcardIssueNumberPlaceholder

Alphanumeric, 32 characters

Placeholder text for the credit card issue number.

creditcardShowExpirationDatePlaceholder

Boolean

Display placeholder text for the credit card expiration date.

creditcardShowIssueDatePlaceholder

Boolean

Display placeholder text for the credit card issue date.

creditcardShowCardholderNameField

Boolean

Display field containing cardholder name.

creditcardShowCvcField

Boolean

Display CVC field.

creditcardShowIssueDateField

Boolean

Display field containing the card issue date.

creditcardShowIssueNumberField

Boolean

Display field containing the card issue number.

Note that these fields must not be included in the fingerprint calculation.

Response Parameters

Table 10. Initialization of QENTA Data Storage
Parameter Data type Description

storageId

Alphanumeric, fixed 32.

Unique ID of your online shop.

javascriptUrl

Alphanumeric

Version number of JavaScript.

Table 11. Credit Card, Mail Order and Telephone Order, and MaestroSecureCode.
Parameter Data type Description

anonymousPan

Numeric, fixed 4.

Anonymized credit card number containing only the rightmost 4 digits.

maskedPan

Numeric with special characters and a variable length of 13 to 19.

Masked credit card number: first 6 numbers followed by * and last 4 numbers of the credit card.

financialInstitution

Enumeration

Financial institution

brand

Enumeration

Brand depending on payment method.

cardholdername

Alphanumeric with special characters.

Name of the cardholder.

expiry

Numeric with special characters.

Expiry date of credit card in the format MM/YYYY.

Table 12. Reading Stored Payment Data from QENTA Data Storage
Parameter Data type Description

storageId

Alphanumeric, fixed 32.

Unique ID of Data Storage.

paymentInformations

Numeric

Number of stored payment methods.

paymentInformation.{n}.paymentType

Alphabetic

Name of payment method.

Table 13. Returned Payment Method Specific Parameters
Parameter Data type Description

paymentInformation.{n}.anonymousPan

Numeric with a fixed length of 4.

Anonymized credit card number containing only the rightmost 4 digits.

paymentInformation.{n}.maskedPan

Numeric with special characters and a variable length of 13 to 19.

masked credit card number: first 6 numbers followed by * and he last 4 numbers of the credit card.

paymentInformation.{n}.financialInstitution

Enumeration

Financial institution.

paymentInformation.{n}.brand

Enumeration

Brand of Credit Card.

paymentInformation.{n}.cardholdername

Alphanumeric with special characters.

Name of cardholder.

paymentInformation.{n}.expiry

Numeric with special characters.

Expiry date of credit card in format MM/YYYY.

paymentInformation.{n}.accountOwner

Alphanumeric with special characters.

Name of owner of account.

paymentInformation.{n}.bankName

Alphanumeric with special characters.

Name of bank.

paymentInformation.{n}.bankCountry

Alphabetic with a fixed length of 2.

Country code of bank.

paymentInformation.{n}.bankAccount

Alphanumeric with a variable length of 1 to 11.

Account number.

paymentInformation.{n}.bankNumber

Numeric with a variable length of 1 to 8.

Bank number.

paymentInformation.{n}.bankBic

Alphanumeric with a variable length of 1 to 255.

BIC of bank.

paymentInformation.{n}.bankAccountIban

Alphanumeric with a variable length of 1 to 255.

IBAN of account.

Be aware that due to PCI DSS compliance, hashedPan can’t be returned either with maskedPan nor anonymousPan.