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.