Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space ENWORK and version Documentation

About
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePartner-Name
PageWithExcerptWording
Instant Payment



(warning) draft (warning)

General information about
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePartner-Name
PageWithExcerptWording
Instant Payment

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePartner-Name
PageWithExcerptWording
Instant Payment is based on the Standard Open Banking and belongs to payment category Online Bank Transfer.

The merchant initiates a payment, the customer is forwarded to an Open Banking Operator to allow country and bank selection and finally forwards the customer to their bank to approve and complete the payment.

Open Banking allows two different modes:

ModeDescription
sepaSupported by all banks and is based on SEPA payments.
sepaInstant

Supported by most banks and is based on SEPA Instant payments so money is transferred to merchant account typically within 10 seconds.



Page properties
 

Table of Contents

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 Instant payment request and receives URL to Open Banking Operator

  • Merchant redirects customer to Open Banking Operator URL
  • Customer enters bank account data (IBAN) and his/her name (account holder name) and confirms payment

  • Merchant's shop gets a notification about successful payment

(tick)

coming soon

full or partial Credit

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

  • not supported

coming soon


full or partial Reversal

Merchant wants to cancel a payment which has not been completed

  • not supported



Process flow chart

draw.io Diagram
bordertrue
diagramNameInstanea Sale
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth1109

Instant Payment process flow


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
interface

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameDefinition
PageWithExcerptDefinition EN


Calling the Open Banking interface

To process a payment with online transfer with Instant Payment, call up the following URL:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
OpenBank.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623741378316_1056203061
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamerequest
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1623741378318_-1881547046
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

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 des Zahlungsvorganges. Sie muss eindeutig und einmalig sein und darf nur aus folgenden Zeichen bestehen: A..Za..z0..9

Table Excerpt Include
statictrue
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Key

Format

CND

Description

Beschreibung

PayTypea..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 type "sepa
sepaInstant

Instanea type "sepaInstant" (default)

Accountan..34OIf you have multiple IBANs configured at Open Banking Operator, you may select another one than the default

OrderDesc

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

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBackoffice-Name
PageWithExcerptWording
.

Beschreibung der gekauften Waren, Einzelpreise etc.

Bitte beachten Sie: Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. In 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBackoffice-Name
PageWithExcerptDE:Wording
können Sie die kompletten Daten einsehen.

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Table Excerpt Include
statictrue
nameURLSuccess
pageURLSuccess
typepage

Table Excerpt Include
statictrue
nameURLFailure
pageURLFailure
typepage

Table Excerpt Include
statictrue
nameResponse
pageResponse
typepage

Table Excerpt Include
statictrue
nameURLNotify
pageURLNotify
typepage

Table Excerpt Include
statictrue
nameReqId-ans..32
pageReqId
typepage

Table Excerpt Include
statictrue
namePlain
pagePlain
typepage

Table Excerpt Include
statictrue
nameCustom
pageCustom
typepage

Parameters for online transfers with Instant Payment


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_IntroURL
PageWithExcerptReuse API

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623742037710_1376413864
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNameresponse
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1623742037712_1947564843
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMID
pagemid
typepage

Table Excerpt Include
statictrue
namePayID
pagePayID
typepage

Table Excerpt Include
statictrue
nameXID
pageXID
typepage

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

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

Table Excerpt Include
statictrue
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

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 des Zahlungsvorganges. Sie muss eindeutig und einmalig sein und darf nur aus folgenden Zeichen bestehen: A..Za..z. Ziffern sind nicht erlaubt!
TransactionIDans..64MUnique transaction id returned by Instanea (transfer-id).Eindeutige TransaktionsId von Instanea (transfer-id).
ExtCoden..3OExternal Response Code from Open Banking Operator

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
namePlain
pagePlain
typepage

Table Excerpt Include
statictrue
nameCustom
pageCustom
typepage

Return parameters for URLSuccess, URLFailure and URLNotify with Instant Payment