Required Parameters

To initiate the payment process set all required parameters to particular values. If one of them is missing error message will be shown.

Required Parameters for QPAY and QMORE

Table 1. Required Parameters for QPAY Checkout Page and QMORE Checkout Seamless
Parameter	Within fingerprint	Data type	Description
`customerId`	Required	Alphanumeric, fixed 7 characters	Unique ID assigned to each merchant by QENTA.
`language`	Required	Alphabetic, fixed 2 characters	Language for displayed texts on the payment page.
`paymentType`	Optional	Enumeration	Selected payment method of the consumer.
`amount`	Required	Amount	Amount of payment.
`currency`	Required	Alphabetic or numeric, fixed 3 characters	Currency code of amount.
`orderDescription`	Required	Alphanumeric, up to 255	Unique description of the consumer’s order in a human readable form.
`successUrl`	Required	Alphanumeric with special characters	URL of the online shop when payment process was successful.
`cancelUrl`	Optional	Alphanumeric with special characters	URL of the online shop when payment process has been canceled.
`failureUrl`	Optional	Alphanumeric with special characters	URL of the online shop when an error occurred within payment process.
`serviceUrl`	Optional	Alphanumeric with special characters, up to 255	URL of web page containing the contact information.
`requestFingerprintOrder`	Required	Alphanumeric with special characters	Ordered list of parameters used for calculating the fingerprint.
`requestFingerprint`	Never	Alphanumeric with a fixed length of 128 for hash mechanism `HMAC-SHA-512`	Computed fingerprint of the parameter values as given in the `requestFingerprintOrder`.

Table 2. Required Parameters for QPAY Checkout Page and QMORE Checkout Seamless
`customerId`
Data	Value
Within fingerprint	Required
Data type	Alphanumeric, fixed 7 characters
Description	Unique ID assigned to each merchant by QENTA.
`language`
Data	Value
Within fingerprint	Required
Data type	Alphabetic, fixed 2 characters
Description	Language for displayed texts on the payment page.
`paymentType`
Data	Value
Within fingerprint	Optional
Data type	Enumeration
Description	Selected payment method of the consumer.
`amount`
Data	Value
Within fingerprint	Required
Data type	Amount
Description	Amount of payment.
`currency`
Data	Value
Within fingerprint	Required
Data type	Alphabetic or numeric, fixed 3 characters
Description	Currency code of amount.
`orderDescription`
Data	Value
Within fingerprint	Required
Data type	Alphanumeric, up to 255
Description	Unique description of the consumer’s order in a human readable form.
`successUrl`
Data	Value
Within fingerprint	Required
Data type	Alphanumeric with special characters
Description	URL of the online shop when payment process was successful.
`cancelUrl`
Data	Value
Within fingerprint	Optional
Data type	Alphanumeric with special characters
Description	URL of the online shop when payment process has been canceled.
`failureUrl`
Data	Value
Within fingerprint	Optional
Data type	Alphanumeric with special characters
Description	URL of the online shop when an error occurred within payment process.
`serviceUrl`
Data	Value
Within fingerprint	Optional
Data type	Alphanumeric with special characters, up to 255
Description	URL of web page containing the contact information.
`requestFingerprintOrder`
Data	Value
Within fingerprint	Required
Data type	Alphanumeric with special characters
Description	Ordered list of parameters used for calculating the fingerprint.
`requestFingerprint`
Data	Value
Within fingerprint	Never
Data type	Alphanumeric with a fixed length of 128 for hash mechanism HMAC-SHA-512
Description	Computed fingerprint of the parameter values as given in the `requestFingerprintOrder`.

Additionally Parameters for QMORE

Table 3. Additionally for QMORE Checkout Seamless
Parameter	Within fingerprint	Data type	Description
`confirmUrl`	Required	Alphanumeric with special characters	URL of the online shop where QENTA sends a server-to-server confirmation.
`consumerIpAddress`	Required	Numeric with special characters	IP address of the consumer.
`consumerUserAgent`	Required	Alphanumeric with special characters	User-agent of the browser of the consumer.
`financialInstitution`	Optional	Enumeration	Based on pre-selected payment method a sub-selection of financial institutions regarding the pre-selected payment method.

Table 4. Additionally for QMORE Checkout Seamless
`confirmUrl`
Data	Value
Within fingerprint	Required
Data type	Alphanumeric with special characters
Description	URL of the online shop where QENTA sends a server-to-server confirmation.
`consumerIpAddress`
Data	Value
Within fingerprint	Required
Data type	Numeric with special characters
Description	IP address of the consumer.
`consumerUserAgent`
Data	Value
Within fingerprint	Required
Data type	Alphanumeric with special characters
Description	User-agent of the browser of the consumer.
`financialInstitution`
Data	Value
Within fingerprint	Optional
Data type	Enumeration
Description	Based on pre-selected payment method a sub-selection of financial institutions regarding the pre-selected payment method.