Required Parameters

Required Parameters

To initiate the payment process you have to set all required parameters to particular values. If one of these required parameters is missing you’ll get an error message.
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 your 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 your online shop when payment process was successful.

cancelUrl

Optional

Alphanumeric with special characters

URL of your online shop when payment process has been canceled.

failureUrl

Optional

Alphanumeric with special characters

URL of your online shop when an error occurred within payment process.

serviceUrl

Optional

Alphanumeric with special characters, up to 255

URL of web page containing your 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. Additionally for QMORE Checkout Seamless
Parameter Within fingerprint Data type Description

confirmUrl

Required

Alphanumeric with special characters

URL of your 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.