interface

Status inquiries via socket connections

Status inquiries based on PayID

Status inquiries within give detailed information about the amounts that are actually authorized, captured or credited. Especially before executing reversals via the interface reverse.aspx it is recommended to check the transaction status with inquire.aspx, because Reverse.aspx reverses not only authorizations but ALWAYS THE LAST TRANSACTION STEP.

Inquiries of transaction status based on PayID are possible via a Server-to-Server connection. In order to inquire about the status of a transaction via a Server-to-Server connection, please use the following URL:

inquire.aspx

Parameters for status inquiries via socket connections

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK or FAILED as status of inquiry and not of the requested transaction	OK oder FAILED als Status der Abfrage, nicht der angefragten Transaktion
Description	a,s..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis! It relates to the inquiry and not to the requested transaction.	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus! Bezieht sich auf die Abfrage und nicht auf die angefragte Transaktion.
Code	n8	M	Error code according to Paygate Response Codes (A4 Error codes). It relates to the inquiry and not to the requested transaction.	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes). Bezieht sich auf die Abfrage und nicht auf die angefragte Transaktion.

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	O	Approved amount	Genehmigter Betrag
AmountCap	n..10	O	Captured amount	Gebuchter Betrag
AmountCred	n..10	O	Credited amount	Gutgeschriebener Betrag
Currency	a3	O	Currency code, three digits DIN / ISO 4217. For payment types that don´t have the "Currency" parameter nothing will be returned.	Währungskürzel, drei Zeichen DIN / ISO 4217. Für Zahlungsarten ohne Parameter "Currency" wird nichts zurückgegeben.
LastStatus	a..50	O	Status of last transaction (Authorisation, Capture or Credit)	Status der letzten Transaktion (Autorisierung, Buchung oder Gutschrift)

Response parameters in the case of status inquiries via socket connections

Notice: The LastStatus parameter is not sufficient to determine the status because it supplies the status of only the last transaction. For example LastStatus delivers the status Failed if a credit has failed although the previous authorisation and capture were successful. The fields AmountAuth, AmountCap and AmountCred give the precise status.

Status inquiries based on TransID

Inquiries of transaction status based on TransID are possible via a Server-to-Server connection. In order to inquire about the status of a transaction via a Server-to-Server connection, please use the following URL:

inquire24.aspx

Parameters for status inquiries via socket connections

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK or FAILED as status of inquiry and not of the requested transaction	OK oder FAILED als Status der Abfrage, nicht der angefragten Transaktion
Description	a,s..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis! It relates to the inquiry and not to the requested transaction.	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus! Bezieht sich auf die Abfrage und nicht auf die angefragte Transaktion.
Code	n8	M	Error code according to Paygate Response Codes (A4 Error codes). It relates to the inquiry and not to the requested transaction.	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes). Bezieht sich auf die Abfrage und nicht auf die angefragte Transaktion.

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	O	Approved amount	Genehmigter Betrag
AmountCap	n..10	O	Captured amount	Gebuchter Betrag
AmountCred	n..10	O	Credited amount	Gutgeschriebener Betrag
Currency	a3	O	Currency code, three digits DIN / ISO 4217. For payment types that don´t have the "Currency" parameter nothing will be returned.	Währungskürzel, drei Zeichen DIN / ISO 4217. Für Zahlungsarten ohne Parameter "Currency" wird nichts zurückgegeben.
LastStatus	a..50	O	Status of last transaction (Authorisation, Capture or Credit)	Status der letzten Transaktion (Autorisierung, Buchung oder Gutschrift)
LastXCode	n8	O	Error code of last transaction according to Response Codes (A4 Error codes)	Fehlercode der letzten Transaktion gemäß Antwort-Codes (A4 Fehlercodes)
LastXAmount	n..10	O	Amount in the smallest currency unit (e.g. EUR Cent)	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)
CCBrand	a..22	O	Credit card brand (e.g. Visa, MasterCard, Maestro etc.) Returned only after configuration by Merchant Services ().	Kreditkartenmarke (z.B. Visa, MasterCard, Maestro usw.) Rückgabe nur nach Konfiguration durch Merchant Services ().

Response parameters in the case of status inquiries via socket connections

Notice: The LastStatus parameter is not sufficient to determine the status because it supplies the status of only the last transaction. For example LastStatus delivers the status Failed if a credit has failed although the previous authorisation and capture were successful. The fields AmountAuth, AmountCap and AmountCred give the precise status.