girocard
Your account must be enabled for this feature.
Only supported for limited acquirers in Germany.
Introduction
In order to send a girocard transactiosn via the RESTful payments API to our gateway you will need to use the requestType 'PaymentTerminalSaleTransaction'. Since the majority of issued cards having the girocard brand, it is recommended to include brand 'DEBITDE_GIRO'.
Supported transaction types
Only sale (purchase) and cancelation (void) are supported. Refunds are not supported by girocard scheme. For this purpose you will need use a SEPA credit transfer.
Acceptance of online and offline transactions
girocard transactions can be processed online or offline depending on terminal floor limit.
girocard instrument that is read as contactless EMV could be processed as:
- Girocard Online with no cardholder verification method (CVM)
- Girocard Online with Online PIN
Transaction counter
Increase of counter
For girocard transactions the terminal will need to send terminalRequestData.traceNumber. girocard transactions can only be processed from the Gateway through a dedicated authorisation system hosted in Germany. It's called Poseidon. For successful transaction processing the traceNumber has to increment the counter by 10.
Update counter (available soon)
When the backend detects that the terminal transaction counter/STAN is out of sync, the corrected value will be returned in ProcessorData.correctedTraceNumber. In the response this will also be indicated in requiredActionOnTerminal with value 'UpdateTraceNumber'.
Printing and displaying of response text
For a successful certification of girocard scheme on a terminal model, the terminal will need to display dedicated response texts on the device display. These texts are passed from the German authorization system through the Gateway in terminalPrintAndDisplayData.
The language of the response text can be determined by sending order.clientLocale.language
If no language is sent, then the response text will be provided in German in the payment response.
In the response the text to display and print is included under processor object.
These are the relevant elements, all located under terminalPrintAndDisplayData:
| Field | Description |
|---|---|
printTextMerchant | Text to be printed on the copy of the merchant receipt |
printTextCardholder | Text to be printed on the cardholder receipt |
displayTextMerchant | Text to be displayed on the merchant-facing screen |
displayTextCardholder | Text to be displayed on the cardholder-facing screen |
authorizationParameterToPrint | Authorization parameter to be printed on the receipt |
Support emergency processing
If a transaction was processed by the terminal under this condition, it needs to send terminalRequestData.emergencyProcessing= 'true'
Updated about 23 hours ago
