About Instanea

General information about Instanea

Instanea is an acceptance solution based on payment initiation as defined by PSD2, which allows you to receive instant transfers.

Through this solution, your company and your customers benefit from all the advantages of instant transfers:

  • Speed: Transfer executed in less than 10 seconds with immediate availability of funds.
  • Convenience: 24/7 availability all year round and notification to the payor in the event of rejection of the transaction.
  • Ease: Choice of the reference of the transfer, allowing you to make an automatic reconciliation
  • Secure payment: no risk of chargeback with SEPA Instant

…And a simple user journey for your customers.

Whether for in-store sales or online on your website, the Instanea user experience is fluid and secure.

Your customer fills their shopping cart – online or in-store:

1. She/he chooses the “Pay by instant transfer” option from among the payment methods offered.

2. Your customer selects his/her bank and gives his/her consent for the transaction, then s/he is redirected to its Bank

3. She/he log in to its online banking

4. She/he validates the transaction using its strong authentication tool provided by its Bank.

When the customer buys in store, a link will be sent to him (via email/SMS). Please contact your Cash Management Relationship Manager for more information about the set up in store.

With Instanea, your customers pay for their purchases with ease. The advantages are numerous, for you and for your customers:

  • You diversify the payment methods offered and improve your conversion rate.
  • You offer payment with no impact on your customers' credit card limits.
  • You reduce the risk of chargeback thanks to the instant transfer (irrevocable transaction).
  • Your accounting reconciliation is facilitated and may be automatized thanks to the unique and customizable reference that you provide, to be found on each instant transfer received.
  • You streamline your customer experience: no data to enter.
  • You offer a means of payment adapted to consumer expectations, accessible on computers and smartphones


(info) Instanea is available with BNP, only.



Logo

Info

Instanea is an acceptance solution based on payment initiation as defined by PSD2, which allows you to receive instant transfers.

Through this solution, your company and your customers benefit from all the advantages of instant transfers:

  • Speed: Transfer executed in less than 10 seconds with immediate availability of funds.
  • Convenience: 24/7 availability all year round and notification to the payor in the event of rejection of the transaction.
  • Ease: Choice of the reference of the transfer, allowing you to make an automatic reconciliation
  • Secure payment: no risk of chargeback with SEPA Instant

…And a simple user journey for your customers.

Whether for in-store sales or online on your website, the Instanea user experience is fluid and secure.

TypePayments by Online Bank Transfer
 

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

  • not supported

  • use "Sale" instead to authorize and capture a payment within one step.


Sale (one-shot)

Merchant wants to collect money from customer via Instanea

  • Merchant's shop initiates Instanea payment request and receives URL to Instanea

  • Merchant redirects customer to Instanea URL

  • Customer enters bank account data (IBAN) and his name (account holder name) and confirms payment

  • Merchant's shop gets a notification about successful payment

(tick)

(tick)

full or partial Credit

Merchant wants to credit some money back to customer after a payment has been successfully completed

  • not supported



full or partial Reversal

Merchant wants to cancel a payment which has not been completed

  • not supported



Process flow charts

Standard Instanea process


Instanea process flow

Instanea with modal-based redirection


Instanea process flow with modal-based redirection


interface


Calling the Instanea interface

To process a payment with online transfer with Instanea, please use the following URL:

instanea.aspx


Key

REST

Format

CND

Description

Beschreibung

RefNr

"referenceNumber": "..."

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

Key

REST

Format

CND

Description

Beschreibung

Language

"language": "..."

a2O

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

PayType

"payment": {"instanea": {"paymentType": "Sepa" }}

"payment": {"instanea": {"paymentType": "SepaInstant" }}

a..11O

Defines type of Instanea payment:

ValueMeaning
sepaInstanea type "Sepa" is used
sepaInstant

Instanea type "SepaInstant" is used

default, if not specified

Definiert die Art der Instanea-Zahlung:

WertBedeutung
sepaInstanea-Typ "Sepa" wird verwendet
sepaInstant

Instanea-Typ "SepaInstant" wird verwendet

Standardwert, falls nicht angegeben

OrderDesc

"order": {"description": "..."}

ans..768

O

Description of purchased goods, unit prices etc.

Please note: The first 27 characters appear on the customer-account statement. You can view the full data in .

  • Allowed characters: A..Za..z0..9 / - ? : ( ) . , +
  • Diactrics like äöüÄÖÜ, áéíóú, àèìòù, âêîôû, ... are not allowed

Beschreibung der gekauften Waren, Einzelpreise etc.

Bitte beachten Sie: Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. In  können Sie die kompletten Daten einsehen.

  • Erlaubte Zeichen: A..Za..z0..9 / - ? : ( ) . , +
  • Sonderzeichen wie äöüÄÖÜ, áéíóú, àèìòù, âêîôû, ... sind nicht erlaubt.

Key

REST

Format

CND

Description

Beschreibung

ReturnRefundAccount"payment": {"instanea": {"returnRefundAccount": "..." }}a4O

Optional parameter to return consumers bank account data in order to create a manual refund:

ValueMeaning
trueIf 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:

WertBedeutung
trueWenn 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"remittanceInfo": "..."ans..50O

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


Key

Format

CND

Description

Beschreibung

Status

a..50

M

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

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!

Die Referenznummer ist obligatorisch und muss für jede Zahlung eindeutig sein. Erlaubte Zeichen sind: A..Za..z. Ziffern sind nicht erlaubt!
TransactionIDans..64MUnique transaction id returned by Instanea (transfer-id).Eindeutige Transaktions-ID von Instanea (transfer-id).

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 journey integrated 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:

  1. 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.
  2. Automatic triggering via Hosted Payment Page (HPP): Merchants using ’s Hosted Payment Page (HPP) can request the automatic triggering of Instaneamodal.aspx. Please contact the to activate this feature and configure your account settings.

Calling the Instaneamodal interface

To process a payment with Instanea online transfer with modal-based redirection, please use the following URL:

instaneamodal.aspx


Key

REST

Format

CND

Description

Beschreibung

RefNr

"referenceNumber": "..."

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

Key

REST

Format

CND

Description

Beschreibung

Language

"language": "..."

a2O

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

PayType

"payment": {"instanea": {"paymentType": "Sepa" }}

"payment": {"instanea": {"paymentType": "SepaInstant" }}

a..11O

Defines type of Instanea payment:

ValueMeaning
sepaInstanea type "Sepa" is used
sepaInstant

Instanea type "SepaInstant" is used

default, if not specified

Definiert die Art der Instanea-Zahlung:

WertBedeutung
sepaInstanea-Typ "Sepa" wird verwendet
sepaInstant

Instanea-Typ "SepaInstant" wird verwendet

Standardwert, falls nicht angegeben

OrderDesc

"order": {"description": "..."}

ans..768

O

Description of purchased goods, unit prices etc.

Please note: The first 27 characters appear on the customer-account statement. You can view the full data in .

  • Allowed characters: A..Za..z0..9 / - ? : ( ) . , +
  • Diactrics like äöüÄÖÜ, áéíóú, àèìòù, âêîôû, ... are not allowed

Beschreibung der gekauften Waren, Einzelpreise etc.

Bitte beachten Sie: Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. In  können Sie die kompletten Daten einsehen.

  • Erlaubte Zeichen: A..Za..z0..9 / - ? : ( ) . , +
  • Sonderzeichen wie äöüÄÖÜ, áéíóú, àèìòù, âêîôû, ... sind nicht erlaubt.

Key

REST

Format

CND

Description

Beschreibung

ReturnRefundAccount"payment": {"instanea": {"returnRefundAccount": "..." }}a4O

Optional parameter to return consumers bank account data in order to create a manual refund:

ValueMeaning
trueIf 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:

WertBedeutung
trueWenn 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"remittanceInfo": "..."ans..50O

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
CustomField[n]"payment": {"InstaneaModalForm": { "template": {"customField: OBJECT }}}ans..50O
Merchants can customize up to 14 special fields (called CustomField1 to CustomField14) on their payment form template. CustomFields are a feature that allows you to show additional information such as your logo, order details and customer details on the payment form.
Special characters (like &, ', <, >) are not allowed - even not "urlencoded".
The usage / display of CustomField{n] depends on the template that is used.
Händler können bis zu 14 spezielle Felder (genannt CustomField1 bis CustomField14) in ihrer Zahlungsformularvorlage anpassen. CustomFields sind eine Funktion, mit der Sie zusätzliche Informationen wie Ihr Logo, Bestelldetails und Kundendetails auf dem Zahlungsformular anzeigen können.
Sonderzeichen (wie &, ', <, >) sind nicht erlaubt - auch nicht "urlencoded".
Die Verwendung bzw. Darstellung der CustomField{n] ist abhängig vom verwendeten Template.

Parameters for online transfers with Instanea with modal-based redirection


Key

Format

CND

Description

Beschreibung

Status

a..50

M

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

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!

Die Referenznummer ist obligatorisch und muss für jede Zahlung eindeutig sein. Erlaubte Zeichen sind: A..Za..z. Ziffern sind nicht erlaubt!
TransactionIDans..64MUnique transaction id returned by Instanea (transfer-id).Eindeutige Transaktions-ID von Instanea (transfer-id).

Return parameters for URLSuccess, URLFailure and URLNotify with Instanea with modal-based redirection