Use cases
Supported use cases | Supported interface | |||
|---|---|---|---|---|
Use case | Description | Simple process | S-2-S | HPP |
Authorization + Capture | Merchant wants to authorize payment and capture on delivery |
| ||
Sale (one-shot) | Merchant wants to collect money from customer via Instanea |
| ||
full or partial Credit | Merchant wants to credit some money back to customer after a payment has been successfully completed |
| ||
full or partial Reversal | Merchant wants to cancel a payment which has not been completed |
| ||
Process flow charts
Standard Instanea process
| Multiexcerpt | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Instanea process flow
Instanea with modal-based redirection
| Multiexcerpt |
|---|
| MultiExcerptName | ProcessFlow_redirection |
|---|
| draw.io Diagram | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| - |
|---|
| multiexcerpt-include | ||||||
|---|---|---|---|---|---|---|
|
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Calling the Instanea interface
To process a payment with online transfer with Instanea, please use the following URL:
|
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filtermultiexcerpt | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| isOR | AND
| Point (
| )
| 0
Table Excerpt Include | isFirstTimeEnter | true | static | true |
Key Format CND Description Beschreibung
Die Referenznummer ist obligatorisch und muss für jede Zahlung eindeutig sein. Erlaubte Zeichen sind: A..Za..z0..9
PayType |
2-stelliger Sprachcode (z.B. it), der für die Zahlungsseiten für den Kunden bevorzugt werden soll
Definiert die Art der Instanea-Zahlung:
OrderDesc ans..768 O
Description of purchased goods, unit prices etc. Please note: The first 37
Beschreibung der gekauften Waren, Einzelpreise etc. Bitte beachten Sie: Die ersten 37 Zeichen erscheinen auf dem Kontoauszug des Kunden (basierend auf Ihrer Konfiguration). In
isFirstTimeEnter | true | static | true | v | 2 | name |
UserData | page | UserData | type | page | Table Excerpt Include |
Beschreibung
Optionaler Parameter zur Rückgabe der Bankkontodaten des Kunden, um eine manuelle Rückerstattung anzulegen: Wert | Bedeutung | true | Wenn der Issuer die Bankkontodaten des Kunden zurückgibt, werden diese als Antwort zurückgegeben.Hierzu ist eine spezielle Instanea-Berechtigung erforderlich, die eingerichtet werden muss.RemittanceInfo | ans..50 | O | The RemittanceInfo parameter
Der Parameter „RemittanceInfo“ wird für Abstimmungszwecke benötigt und stellt wichtige, für den Kunden sichtbare Informationen auf Kundenkontoauszügen bereit, um eine bessere Nachverfolgung und Berichterstattung zu ermöglichen.
|
Parameters for online transfers with Instanea
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Response_IntroURL PageWithExcerpt Reuse API
| default | Beschreibung |
|---|---|
| isFirstTimeEnter | false |
| hideColumns | true |
| sparkName | Sparkline |
| hidePane | true |
| datepattern | dd M yy |
| id | 1623742037710_1376413864 |
| worklog | 365|5|8|y w d h m|y w d h m |
| isOR | AND |
| separator | Point (.) |
| order | 0 |
| MultiExcerptName | instanea_response |
|---|
| dateFormat | dd M yy |
|---|---|
| export-word | false |
| show-source | false |
| export-csv | false |
| id | 1623742037712_1947564843 |
| transpose | false |
| worklog | 365|5|8|y w d h m|y w d h m |
| separator | . |
| export-pdf | false |
| sql | SELECT * FROM T* |
Table Excerpt Include isFirstTimeEnter true static true v 2 name MID page mid type page
Table Excerpt Include isFirstTimeEnter true static true v 2 name PayID page PayID type page
Table Excerpt Include isFirstTimeEnter true static true v 2 name XID page XID type page
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
Beschreibung
a..50
OK (URLSuccess) or FAILED (URLFailure)
AUTHORIZE_REQUEST (URLSuccess), Description=PENDING: it may take up to an hour to get final status
OK (URLSuccess) oder FAILED (URLFailure)
AUTHORIZE_REQUEST (URLSuccess), Description=PENDING: es dauert bis zu einer Stunde bis zum finalen Status
Table Excerpt Include isFirstTimeEnter true static true v 2 name Description page Description type page
Table Excerpt Include isFirstTimeEnter true static true v 2 name Code page Code type page
Key
Format
CND
Description
Beschreibung
RefNr
ans..30
M
Reference is mandatory and must be unique for each payment, allowed characters: A..Za..z. Digits are not allowed!
Table Excerpt Include static true name UserData page UserData type page
Table Excerpt Include static true name MAC page MAC type page
| Table Excerpt Include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Return parameters for URLSuccess, URLFailure and URLNotify with Instanea
Instanea with modal-based redirection
To enhance the user experience and ensure compatibility with mobile applications, merchants can use a modal-based redirection flow for Instanea payments. The InstaneaModal.aspx form works seamlessly with a modal overlay that initiates the payment process. This approach keeps the payment journeyintegrated within your website or mobile application, while ensuring compatibility with app-to-app redirection and browser-based flows.Redirection Page Behavior
- The bank selection page (redirection page) is expected to open in a separate window.
- If app-to-app redirection is supported, the redirection will take users directly to their bank’s app without requiring additional user interaction.
Integration Approach
Merchants have two options for using Instaneamodal.aspx:
- Direct Merchant Integration: Merchants can directly integrate Instaneamodal.aspx into their payment flow. By launching the modal from their site or app, the payment process stays seamless for the end user.
- Automatic triggering via Hosted Payment Page (HPP): Merchants using
’s Hosted Payment Page (HPP) can request the automatic triggering of Instaneamodal.aspx. Please contact theMultiexcerpt include SpaceWithExcerpt EN MultiExcerptName Partner-Name PageWithExcerpt Wording
to activate this feature and configure your account settings.Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Helpdesk-Name PageWithExcerpt Wording
Calling the Instaneamodal interface
To process a payment with Instanea online transfer with modal-based redirection, please use the following URL:
instaneamodal.aspxMultiexcerpt include SpaceWithExcerpt EN MultiExcerptName BaseURL PageWithExcerpt Wording
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| default | Beschreibung |
|---|---|
| isFirstTimeEnter | false |
| hideColumns | true |
| sparkName | Sparkline |
| hidePane | true |
| datepattern | dd M yy |
| id | 1741856088624_1929859839 |
| worklog | 365|5|8|y w d h m|y w d h m |
| isOR | AND |
| separator | Point (.) |
| order | 0 |
| MultiExcerptName | instaneamodal_request |
|---|
| dateFormat | dd M yy |
|---|---|
| export-word | false |
| show-source | false |
| export-csv | false |
| id | 1741856088627_1308750093 |
| transpose | false |
| worklog | 365|5|8|y w d h m|y w d h m |
| separator | . |
| export-pdf | false |
| sql | SELECT * FROM T* |
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
Beschreibung
RefNr
an..18
M
Reference is mandatory and must be unique for each payment, allowed characters: A..Za..z0..9.
Die Referenznummer ist obligatorisch und muss für jede Zahlung eindeutig sein. Erlaubte Zeichen sind: A..Za..z0..9
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
Beschreibung
2-letter language code (e.g.. it) that should be preferred when presenting payment pages to the consumer
2-stelliger Sprachcode (z.B. it), der für die Zahlungsseiten für den Kunden bevorzugt werden soll
Defines type of Instanea payment:
| Value | Meaning |
|---|---|
| sepa | Instanea type "Sepa" is used |
| sepaInstant | Instanea type "SepaInstant" is used default, if not specified |
Definiert die Art der Instanea-Zahlung:
| Wert | Bedeutung |
|---|---|
| sepa | Instanea-Typ "Sepa" wird verwendet |
| sepaInstant | Instanea-Typ "SepaInstant" wird verwendet Standardwert, falls nicht angegeben |
OrderDesc
ans..768
O
Description of purchased goods, unit prices etc.
Please note: The first 37 characters appear on the customer-account statement (based on your configuration). You can view the full data in
.Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Backoffice-Name PageWithExcerpt Wording
- Recommended characters: A–Z, a–z, 0–9, /, -, ?, :, (, ), ., ,, +
- Important: Some special or accented characters (e.g. äöüÄÖÜ, áéíóú, àèìòù, âêîôû etc.) may lead to transaction rejections by certain banks.
Beschreibung der gekauften Waren, Einzelpreise etc.
Bitte beachten Sie: Die ersten 37 Zeichen erscheinen auf dem Kontoauszug des Kunden (basierend auf Ihrer Konfiguration). In
können Sie die kompletten Daten einsehen.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Backoffice-Name PageWithExcerpt DE:Wording
- Empfohlene Zeichen: A–Z, a–z, 0–9, /, -, ?, :, (, ), ., ,, +
- Wichtig: Einige Sonderzeichen oder Akzentzeichen (z.B. äöüÄÖÜ, áéíóú, àèìòù, âêîôû usw.) können bei manchen Banken zur Ablehnung von Transaktionen führen.
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Table Excerpt Include | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
Beschreibung
Optional parameter to return consumers bank account data in order to create a manual refund:
| Value | Meaning |
|---|---|
| true | If issuer returns consumers bank account data they will be returned in response. Therefore a specific Instanea-permission is required which needs to be set up. |
Optionaler Parameter zur Rückgabe der Bankkontodaten des Kunden, um eine manuelle Rückerstattung anzulegen:
Parameters for online transfers with Instanea
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Response_IntroURL PageWithExcerpt Reuse API
| Multiexcerpt | ||
|---|---|---|
|
The RemittanceInfo parameter is required for reconciliation purposes, providing essential customer-visible information on customer bank statements for better tracking and reporting.
- Allowed characters: A..Za..z0..9 / - ? : ( ) . , +
- Diactrics like äöüÄÖÜ, áéíóú, àèìòù, âêîôû, ... are not allowed
Der Parameter „RemittanceInfo“ wird für Abstimmungszwecke benötigt und stellt wichtige, für den Kunden sichtbare Informationen auf Kundenkontoauszügen bereit, um eine bessere Nachverfolgung und Berichterstattung zu ermöglichen.
- Erlaubte Zeichen: A..Za..z0..9 / - ? : ( ) . , +
- Umlaute wie äöüÄÖÜ, áéíóú, àèìòù, âêîôû, ... sind nicht zulässig
Parameters for online transfers with Instanea with modal-based redirection
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Response_IntroURL PageWithExcerpt Reuse API
| Table Filter | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Multiexcerpt | MultiExcerptName | instaneamodal
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OK (URLSuccess) oder FAILED (URLFailure) AUTHORIZE_REQUEST (URLSuccess), Description=PENDING: es dauert bis zu einer Stunde bis zum finalen Status
Die Referenznummer ist obligatorisch und muss für jede Zahlung eindeutig sein. Erlaubte Zeichen sind: A..Za..z. Ziffern sind nicht erlaubt! |
|
Return parameters for URLSuccess, URLFailure and URLNotify with Instanea with modal-based redirection