Response Parameters

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".

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.

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.

For failed payments

QPAY Checkout Page

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.

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.

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.

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

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

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.