QENTA Checkout Journal

QENTA Checkout Journal is a web interface that analysis all transactions carried out in the Online Shop – independent of the payment result. It gives an overview of transaction details when doing a checkout for QPAY Checkout Page and QMORE Checkout Seamless. Can be used during the integration process and no installation of the software is required.

Using QENTA Checkout Journal

The login can be found at the following link.

The username and password must be entered
When the login was successful, a summary of the login data is displayed.

After the first login, a new password must be set.

Search Parameters

Field name Data Type Description

Order number

Numeric, up to 9.

The order number of payment. Only searchable if transaction was successful.

Date (not before)

Date as DD.MM.YYYY.

All initiations after the chosen date.

Date (not after)

Date as DD.MM.YYYY.

All initiations before the chosen date.

All initiations will remain in the online databases for 3 months.

Status

Alphanumeric with special characters

The status of a transaction. Accepted values:

successful
canceled
pending
in progress
erroneous initiations

Client IP

Alphanumeric with special characters.

Client IP address.

Initiation parameter value

Data type of used parameter.

Initiation parameter value (all parameters that are used for an initiation e.g.consumer email, consumerBirthDate…).

Return parameter value

Data type of used parameter.

Return parameter value.

Checkout Journal can display a maximum of 1000 sessions.

Search Result

Table 2. Search Result
Field name	Description
Initiation timestamp	Timestamp of initiation payment e.g. `2023-02-12 15:08:25`.
Last activity timestamp	Timestamp of the last activity e.g. `2023-02-12 15:08:25`.
Shop-ID	Unique ID of the online shop within the customer ID.
Session	Unique Session IDentifier for each invoked session.
Result	Result of a payment process (`SUCCESS`, `CANCEL`, `FAILURE`, `PENDING`).
Ordernumber	The number that the merchant got after the transaction is successful.

Transaction Details

Transaction details include:

General Information
Initiation Parameters
Return Parameters
Customer Activity within a Transaction

All transaction details can be exported as a PDF file and the example below is based on this pdf example.

General Information

This general information about a transaction can be included:

Field name Description

Field name	Description
Initiation timestamp	Timestamp of initiation payment.
Last activity timestamp	Timestamp of the last activity.
Customer-ID	Unique ID assigned to each merchant by QENTA.
Shop-ID	Unique ID of the online shop within the customer ID.
Session	Unique Session IDentifier for each invoked session.
Result	Result of a payment process (`SUCCESS`, `CANCEL`, `FAILURE`, `PENDING`).
Order number	The unique order number of the successful payment within the session.
UserAgent	User Agent that consumers have used.
Client-IP	Client IP address.
Protocol Version	The protocol version number.
Application Version	The version of the application.
Hostname	Hostname

Initiation timestamp

Timestamp of initiation payment.

Last activity timestamp

Timestamp of the last activity.

Customer-ID

Unique ID assigned to each merchant by QENTA.

Shop-ID

Unique ID of the online shop within the customer ID.

Session

Unique Session IDentifier for each invoked session.

Result

Result of a payment process (SUCCESS, CANCEL, FAILURE, PENDING).

Order number

The unique order number of the successful payment within the session.

UserAgent

User Agent that consumers have used.

Client-IP

Client IP address.

Protocol Version

The protocol version number.

Application Version

The version of the application.

Hostname

Initiation Parameters

Initiation parameters are different depending on the transaction that is made.

Field name Description

Field name	Description
`initUrl`	Specific URL.
`customerId`	Unique ID assigned to each merchant by QENTA.
`shopId`	The parameter defines the unique identifier for the online shop within `customerId`.
`successUrl`	URL of the online shop when a payment process was successful.
`failureUrl`	URL of the online shop when an error occurred within a payment process.
`cancelUrl`	URL of the online shop when a payment process has been canceled.
`serviceUrl`	URL of web page containing the contact information.
`imageUrl`	URL of the online shop where the online shop logo is located.
`amount`	Amount of payment.
`currency`	Currency code of amount.
`language`	Language for displayed texts on the payment page.
`orderDescription`	Unique description of the consumer’s order.
`displayText`	Text displayed to the consumer during the payment process.
`referer`	Custom parameter.
`configuration`	Custom parameter.
`duplicateRequestCheck`	Check for duplicate requests done by the consumer.
`requestFingerprintOrder`	Ordered list of parameters used for calculating the fingerprint.
`requestFingerprint`	Computed fingerprint of the parameter values as given in the `requestFingerprintOrder`.
`try`	Custom parameter.
`backgroundColor`	Hex code RGB color value as a background color for the brand image containing the credit card logos.
`paymentType`	Selected payment method of the consumer.
`windowName`	Window name of a browser window where the payment page is opened.
`consumerEmail`	E-mail address of the consumer.
`consumerBirthDate`	Birth date of the consumer.
`consumerBillingFirstname`	First name of the consumer.
`consumerBillingLastname`	Last name of the consumer.
`consumerBillingAddress1`	Name of the street and optionally the house number.
`consumerBillingAddress2`	The house number if not already set in `consumerBillingAddress1`.
`consumerBillingCity`	Billing city.
`consumerBillingZIPCode`	Billing zip code.
`consumerBillingState`	Billing state.
`consumerBillingCountry`	Billing country code ISO 3166-1.

initUrl

Specific URL.

customerId

Unique ID assigned to each merchant by QENTA.

shopId

The parameter defines the unique identifier for the online shop within customerId.

successUrl

URL of the online shop when a payment process was successful.

failureUrl

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

cancelUrl

URL of the online shop when a payment process has been canceled.

serviceUrl

URL of web page containing the contact information.

imageUrl

URL of the online shop where the online shop logo is located.

amount

Amount of payment.

currency

Currency code of amount.

language

Language for displayed texts on the payment page.

orderDescription

Unique description of the consumer’s order.

displayText

Text displayed to the consumer during the payment process.

referer

Custom parameter.

configuration

Custom parameter.

duplicateRequestCheck

Check for duplicate requests done by the consumer.

requestFingerprintOrder

Ordered list of parameters used for calculating the fingerprint.

requestFingerprint

Computed fingerprint of the parameter values as given in the requestFingerprintOrder.

try

Custom parameter.

backgroundColor

Hex code RGB color value as a background color for the brand image containing the credit card logos.

paymentType

Selected payment method of the consumer.

windowName

Window name of a browser window where the payment page is opened.

consumerEmail

E-mail address of the consumer.

consumerBirthDate

Birth date of the consumer.

consumerBillingFirstname

First name of the consumer.

consumerBillingLastname

Last name of the consumer.

consumerBillingAddress1

Name of the street and optionally the house number.

consumerBillingAddress2

The house number if not already set in consumerBillingAddress1.

consumerBillingCity

Billing city.

consumerBillingZIPCode

Billing zip code.

consumerBillingState

Billing state.

consumerBillingCountry

Billing country code ISO 3166-1.

Return Parameters

Field name Description

Field name	Description
`amount`	Amount of payment.
`currency`	Currency code of amount.
`paymentType`	Selected payment method of the consumer.
`financialInstitution`	Sub-selection of financial institutions regarding to pre-selected payment method.
`language`	Language used for displayed texts on payment page.
`orderNumber`	The unique order number of the successful payment within the session.
`paymentState`	Result of payment process (`SUCCESS`, `CANCEL`, `FAILURE`, `PENDING`).
`referer`	Custom parameter.
`configuration`	Custom parameter.
`try`	Custom parameter.
`authenticated`	Returns `YES` if the cardholder has been successfully authenticated; otherwise `NO`.
`anonymousPan`	Last four digits of the credit card number.
`expiry`	Expiry date of credit card in format `mm/yyyy`.
`cardholder`	Name of holder of credit card which can only be used if the acquirer supports it.
`maskedPan`	PCI-compliant masked card number in the format: first 6 digits and last 4 digits of card number with "*" in-between depending on the current format of the card number.
`gatewayReferenceNumber`	Technical reference number of the processor.
`responseFingerprintOrder`	Ordered list of parameters used for calculating the fingerprint.
`responseFingerprint`	Returned fingerprint of the parameter values as given in the `responseFingerprintOrder`.

amount

Amount of payment.

currency

Currency code of amount.

paymentType

Selected payment method of the consumer.

financialInstitution

Sub-selection of financial institutions regarding to pre-selected payment method.

language

Language used for displayed texts on payment page.

orderNumber

The unique order number of the successful payment within the session.

paymentState

Result of payment process (SUCCESS, CANCEL, FAILURE, PENDING).

referer

Custom parameter.

configuration

Custom parameter.

try

Custom parameter.

authenticated

Returns YES if the cardholder has been successfully authenticated; otherwise NO.

anonymousPan

Last four digits of the credit card number.

expiry

Expiry date of credit card in format mm/yyyy.

cardholder

Name of holder of credit card which can only be used if the acquirer supports it.

maskedPan

PCI-compliant masked card number in the format: first 6 digits and last 4 digits of card number with "*" in-between depending on the current format of the card number.

gatewayReferenceNumber

Technical reference number of the processor.

responseFingerprintOrder

Ordered list of parameters used for calculating the fingerprint.

responseFingerprint

Returned fingerprint of the parameter values as given in the responseFingerprintOrder.

Customer Activity within a Transaction

A detailed description of all activity within a transaction.

Field name	Description
Timestamp	Timestamp of activity.
Page	Page in which activity occurred.
Information	Information about the occurred activity.

Field name

Description

Timestamp

Timestamp of activity.

Page

Page in which activity occurred.

Information

Information about the occurred activity.

QENTA Checkout Journal