Response Parameters

General information

This page describes the response parameters returned from the QENTA Checkout Server to your online shop.

Take the following information into consideration during integration into your online shop:

Use the same upper- and lowercase writing of the parameter names and values as described.
Check all responses of the QENTA Checkout Server by using the fingerprint method as described in the sections describing the handling of the response parameters.
Some payment methods return additional response parameters or may have other particular requirements regarding response parameters. Therefore the number of response parameters is not fixed. Have a look at the Payment method specific documentation for more information about the use of these additional response parameters and particular parameters.

The number of response parameters is not fixed, but depends on the payment method.

State parameters

Parameter	Data type	Short description
paymentState	Enumeration	Result of payment process: "SUCCESS", "CANCEL", "FAILURE" or "PENDING".

Parameter

Data type

Short description

paymentState

Enumeration

Result of payment process: "SUCCESS", "CANCEL", "FAILURE" or "PENDING".

For successful or pending payments

Parameter	Data type	Short description
financialInstitution	Enumeration	Based on pre-selected payment method a sub-selection of financial institutions regarding to pre-selected payment method.
Request Parameters	Alphabetic with a fixed length of 2.	Language used for displayed texts on payment page.
orderNumber	Numeric value with a variable length of up to 9 digits.	Unique number identifying the payment.
paymentType	Enumeration	Selected payment method of your consumer.
responseFingerprint	Alphanumeric with a fixed length of 128.	Returned fingerprint of the parameter values as given in the requestFingerprintOrder.
responseFingerprintOrder	Alphanumeric with special characters.	Ordered list of parameters used for calculating the fingerprint.

Parameter

Data type

Short description

financialInstitution

Enumeration

Based on pre-selected payment method a sub-selection of financial institutions regarding to pre-selected payment method.

Request Parameters

Alphabetic with a fixed length of 2.

Language used for displayed texts on payment page.

orderNumber

Numeric value with a variable length of up to 9 digits.

Unique number identifying the payment.

paymentType

Enumeration

Selected payment method of your consumer.

responseFingerprint

Alphanumeric with a fixed length of 128.

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

responseFingerprintOrder

Alphanumeric with special characters.

Ordered list of parameters used for calculating the fingerprint.

Additionally for successful payments

Parameter	Data type	Short description
amount	Amount	Amount of payment.
currency	Alphabetic with a fixed length of 3.	Currency code of amount.
gatewayContractNumber	Alphanumeric with special characters with a variable length of up to 255 characters.	Contract number of the processor or acquirer.
gatewayReferenceNumber	Alphanumeric with special characters with a variable length of up to 255 characters.	Technical reference number of the processor.
providerReferenceNumber	Alphanumeric with special characters with a variable length of up to 255 characters.	Technical reference number of the financial service provider or acquirer. ^[1] Please contact our support teams to enable this feature.

Parameter

Data type

Short description

amount

Amount

Amount of payment.

currency

Alphabetic with a fixed length of 3.

Currency code of amount.

gatewayContractNumber

Alphanumeric with special characters with a variable length of up to 255 characters.

Contract number of the processor or acquirer.

gatewayReferenceNumber

Alphanumeric with special characters with a variable length of up to 255 characters.

Technical reference number of the processor.

providerReferenceNumber

Alphanumeric with special characters with a variable length of up to 255 characters.

Technical reference number of the financial service provider or acquirer. ^[1]
Please contact our support teams to enable this feature.

For failed payments

QPAY Checkout Page

Parameter	Data type	Short description
message	Alphanumeric with special characters.	Error text describing the failure.

Parameter

Data type

Short description

message

Alphanumeric with special characters.

Error text describing the failure.

QMORE Checkout Seamless

Parameter	Data type	Short description
errors	Numeric	Number of errors occurred.
error.{n}.errorCode	Numeric with a fixed length of 5.	Numeric error code which you should log for later use.
error.{n}.message	Alphanumeric with special characters.	Error message in English.
error.{n}.consumerMessage	Alphanumeric with special characters.	Error message in localized language for your consumer.
error.{n}.paySysMessage	Alphanumeric with special characters.	Payment method system specific error message only relevant for merchant.

Parameter

Data type

Short description

errors

Numeric

Number of errors occurred.

error.{n}.errorCode

Numeric with a fixed length of 5.

Numeric error code which you should log for later use.

error.{n}.message

Alphanumeric with special characters.

Error message in English.

error.{n}.consumerMessage

Alphanumeric with special characters.

Error message in localized language for your consumer.

error.{n}.paySysMessage

Alphanumeric with special characters.

Payment method system specific error message only relevant for merchant.

Payment method specific parameters

For some payment methods you will get specific response parameters which are only sent if those payment methods are enabled for your online shop and used by your consumers. Please have a look at the payment specific documentation regarding these parameters and their meaning at Integration of specific payment methods.

Feature-specific parameters

These response parameters enhance the result data of the payment process regarding specific features and functions and are enabled by QENTA on your behalf.

To enable one or more of these response parameters contact our support teams.

Parameter	State	Data type	Short description
liabilityShiftIndicator	Success	Alphabetic with a fixed length of 1 and possible value of "Y" or "N".	Only available and returns "Y" if it indicates liability shift, otherwise this parameter is not returned or returns "N". Please be aware that exception exists for corporate cards and interregional transactions.
instrumentCountry	Success	Alphabetic with a fixed length of 2.	Country of the consumer which has been detected and returned by the financial service provider. Please be aware that this feature is not provided by all financial service providers.

Parameter

State

Data type

Short description

liabilityShiftIndicator

Success

Alphabetic with a fixed length of 1 and possible value of "Y" or "N".

Only available and returns "Y" if it indicates liability shift, otherwise this parameter is not returned or returns "N". Please be aware that exception exists for corporate cards and interregional transactions.

instrumentCountry

Success

Alphabetic with a fixed length of 2.

Country of the consumer which has been detected and returned by the financial service provider. Please be aware that this feature is not provided by all financial service providers.

The parameter instrumentCountry is also returned via the transaction-based operation (back-end operation) getOrderDetails both for QPAY Checkout Page and QMORE Checkout Seamless.

QENTA Fraud Prevention Suite (FPS) parameters

If you have enabled the Wirecard Fraud Prevention Suite (FPS) on your behalf, you can use the following return parameter.

Please be aware that these parameters are only returned via request_parameters#confirmUrl and request_parameters#confirmMail. For security reasons these parameters are not returned to any other URL!

Parameter	State	Data type	Short description
riskIntercept	Pending, failure and success.	Numeric with a variable length of up to 5 digits.	Result of FPS check: 0 .. accept; 1 .. manual review; 2 .. reject.
riskReasonCode	Pending, failure and success.	Numeric with a variable length of up to 5 digits.	Code of rejection reason.
riskReasonMessage	Pending, failure and success.	Alphanumeric with a variable length of up to 1024 characters.	Message containing additional details for the rejection reason code.
riskReturnCode	Pending, failure and success.	Numeric with a variable length of up to 5 digits.	Return code of the fraud verification.
riskReturnMessage	Pending, failure and success.	Alphanumeric with a variable length of up to 1024 characters.	Return message of the fraud prevention.

Parameter

State

Data type

Short description

riskIntercept

Pending, failure and success.

Numeric with a variable length of up to 5 digits.

Result of FPS check: 0 .. accept; 1 .. manual review; 2 .. reject.

riskReasonCode

Pending, failure and success.

Numeric with a variable length of up to 5 digits.

Code of rejection reason.

riskReasonMessage

Pending, failure and success.

Alphanumeric with a variable length of up to 1024 characters.

Message containing additional details for the rejection reason code.

riskReturnCode

Pending, failure and success.

Numeric with a variable length of up to 5 digits.

Return code of the fraud verification.

riskReturnMessage

Pending, failure and success.

Alphanumeric with a variable length of up to 1024 characters.

Return message of the fraud prevention.

An example of the returned parameters can be:

riskIntercept=2
riskReasonCode=60
riskReasonMessage=IP/BIN check failed.
riskReturnCode=507
riskReturnMessage=General Risk Rejection.

Please be aware that you can use the FPS only for the following payment types: CCARD and CCARD-MOTO.

Custom parameters

All your custom parameters are returned independently of the payment result.

Detailed description of parameters

financialInstitution

Value of parameter
paymentType Possible value(s) of parameter
financialInstitution Description

Value of parameter `paymentType`	Possible value(s) of parameter `financialInstitution`	Description
BANCONTACT_MISTERCASH	Bancontact/Mister Cash	Bancontact/Mister Cash
CCARD / CCARD-MOTO / MASTERPASS	MC	Mastercard
:::	MC	Mastercard SecureCode
:::	MAESTRO	Maestro SecureCode
:::	Visa	Visa
:::	Visa	Verified by Visa
:::	Amex	American Express
:::	Amex	American Express SafeKey
:::	Diners	Diners Club
:::	Discover	Discover
:::	JCB	JCB
:::	J/Secure	J/Secure™
CCARD / CCARD-MOTO	UATP	Universal Airline Travel Plan
EPAY_BG	ePay.bg	ePay.bg
EPS	ARZ	AAB
Austrian Anadi Bank AG	:::	ARZ
BAF	Österreichische Ärzte- und Apothekerbank	:::
ARZ	MB	Marchfelder Bank
:::	BA-CA	Bank Austria
:::	ARZ	BCS
Bankhaus Carl Spängler & Co. AG	:::	ARZ
BSS	Bankhaus Schelhammer & Schattera AG	:::
Bawag	BG	BAWAG P.S.K. AG
:::	ARZ	BKS
BKS Bank AG	:::	ARZ
BKB	Brüll Kallmus Bank AG	:::
ARZ	BTV	BTV VIER LÄNDER BANK
:::	ARZ	CBGG
Capital Bank Grawe Gruppe AG	:::	ARZ
DB	Dolomitenbank	:::
Bawag	EB	Easybank AG
:::	Spardat	EBS
Erste Bank und Sparkassen	:::	ARZ
HAA	Hypo Alpe-Adria-Bank International AG	:::
ARZ	VLH	Hypo Vorarlberg Bank AG
:::	ARZ	NLH
HYPO NOE LB für Niederösterreich u. Wien	:::	Hypo-Racon
O	Hypo Oberösterreich	:::
Hypo-Racon	S	Hypo Salzburg
:::	Hypo-Racon	St
Hypo Steiermark	:::	ARZ
HTB	Hypo Tirol Bank AG	:::
BB-Racon	Bank Burgenland	:::
ARZ	OB	Oberbank AG
:::	Racon	Raiffeisen Bankengruppe Österreich
:::	ARZ	SB
Schoellerbank AG	:::	Bawag
SBW	Sparda Bank Wien	:::
ARZ	VB	Volksbank Gruppe
:::	ARZ	VKB
Volkskreditbank AG	:::	ARZ
VRB	VR-Bank Braunau	GIROPAY
GIROPAY	giropay	IDL
ABNAMROBANK	ABN AMRO Bank	:::
ASNBANK	ASN Bank	:::
BUNQ	Bunq Bank	:::
INGBANK	ING	:::
KNAB	Knab	:::
RABOBANK	Rabobank	:::
SNSBANK	SNS Bank	:::
REGIOBANK	Regio Bank	:::
TRIODOSBANK	Triodos Bank	:::
VANLANSCHOT	Van Lanschot Bankiers	INVOICE
payolution	payolution	:::
RatePAY	RatePAY	:::
Wirecard	Wirecard	INSTALLMENT
payolution	payolution	:::
RatePAY	RatePAY	MONETA
moneta.ru	moneta.ru	PAYPAL
PAYPAL	PayPal	PBX
PBX	Mobile Phone Invoice	POLI
POLi	POLi	PRZELEWY24
Przelewy24	Przelewy24	SEPA-DD
SEPA-DD	SEPA Direct Debit	SKRILLWALLET
Skrill Digital Wallet	Skrill Digital Wallet	SOFORTUEBERWEISUNG
SOFORTUEBERWEISUNG	Sofort.	TATRAPAY
TatraPay	TatraPay	TRUSTLY
TRUSTLY	Trustly	TRUSTPAY

BANCONTACT_MISTERCASH

Bancontact/Mister Cash

CCARD / CCARD-MOTO / MASTERPASS

Mastercard

:::

Mastercard SecureCode

:::

MAESTRO

Maestro SecureCode

:::

Visa

:::

Visa

Verified by Visa

:::

Amex

American Express

:::

Amex

American Express SafeKey

:::

Diners

Diners Club

:::

Discover

:::

JCB

:::

J/Secure

J/Secure™

CCARD / CCARD-MOTO

UATP

Universal Airline Travel Plan

EPAY_BG

ePay.bg

EPS

ARZ

AAB

Austrian Anadi Bank AG

:::

ARZ

BAF

Österreichische Ärzte- und Apothekerbank

:::

ARZ

Marchfelder Bank

:::

BA-CA

Bank Austria

:::

ARZ

BCS

Bankhaus Carl Spängler & Co. AG

:::

ARZ

BSS

Bankhaus Schelhammer & Schattera AG

:::

Bawag

BAWAG P.S.K. AG

:::

ARZ

BKS

BKS Bank AG

:::

ARZ

BKB

Brüll Kallmus Bank AG

:::

ARZ

BTV

BTV VIER LÄNDER BANK

:::

ARZ

CBGG

Capital Bank Grawe Gruppe AG

:::

ARZ

Dolomitenbank

:::

Bawag

Easybank AG

:::

Spardat

EBS

Erste Bank und Sparkassen

:::

ARZ

HAA

Hypo Alpe-Adria-Bank International AG

:::

ARZ

VLH

Hypo Vorarlberg Bank AG

:::

ARZ

NLH

HYPO NOE LB für Niederösterreich u. Wien

:::

Hypo-Racon

Hypo Oberösterreich

:::

Hypo-Racon

Hypo Salzburg

:::

Hypo-Racon

Hypo Steiermark

:::

ARZ

HTB

Hypo Tirol Bank AG

:::

BB-Racon

Bank Burgenland

:::

ARZ

Oberbank AG

:::

Racon

Raiffeisen Bankengruppe Österreich

:::

ARZ

Schoellerbank AG

:::

Bawag

SBW

Sparda Bank Wien

:::

ARZ

Volksbank Gruppe

:::

ARZ

VKB

Volkskreditbank AG

:::

ARZ

VRB

VR-Bank Braunau

GIROPAY

giropay

IDL

ABNAMROBANK

ABN AMRO Bank

:::

ASNBANK

ASN Bank

:::

BUNQ

Bunq Bank

:::

INGBANK

ING

:::

KNAB

Knab

:::

RABOBANK

Rabobank

:::

SNSBANK

SNS Bank

:::

REGIOBANK

Regio Bank

:::

TRIODOSBANK

Triodos Bank

:::

VANLANSCHOT

Van Lanschot Bankiers

INVOICE

payolution

:::

RatePAY

:::

Wirecard

INSTALLMENT

payolution

:::

RatePAY

MONETA

moneta.ru

PAYPAL

PayPal

PBX

Mobile Phone Invoice

POLI

POLi

PRZELEWY24

Przelewy24

SEPA-DD

SEPA Direct Debit

SKRILLWALLET

Skrill Digital Wallet

SOFORTUEBERWEISUNG

Sofort.

TATRAPAY

TatraPay

TRUSTLY

Trustly

TRUSTPAY

instrumentCountry

From January 1, 2015 a new rule applies on the sale of digital goods (exclusively digital goods) to consumers in EU countries. According to this rule the merchant is responsible for accounting for VAT to the respective authority of the consumer’s EU member state. Since in the case of digital goods the information on the consumer’s country cannot be derived from the delivery address, information on the consumer’s country is taken from the data returned to QENTA by the respective financial service provider. E.g. in the case of credit cards, the country of the credit card issuer is returned and used to determine the consumer’s country.

Currently, this parameter may be used for the following payment methods: Credit Card, iDEAL, PayPal and Sofort.

1. For some systems and payment methods the technical reference number is only available within the gatewayReferenceNumber.