SEPA

Last changes: 09-22-2020


  1. Get Financial Institution Data
  2. Initiate Authorization
  3. Collect Payment Option Details via SDK
  4. SEPA Mandate Acceptance Page
  5. Complete Authorization

 

1. Get Financial Institution Data

Before initializing the authorization process, call the API method 1.84 Get Financial Institution Data.

Get Financial Institution Data Request

Path:

GET {Base URL}/settings/getFinancialInstitutionData?localDate=2017-08- 21&localTime=170911&partnerReference=TEST-4H363TJC68

Header:

Content-Type: application/json
Accept-Language: en-US

This will provide you with information about the financial institution, which will act as a Creditor in the SEPA Direct Debit process. This information is necessary for the SEPA Mandate Acceptance Page.

Get Financial Institution Data Response

Status Code:

200 (OK)

Header:

Content-Type: application/json
Accept-Language: en-US

{
    "name": "Volkswagen Payments S.A. (SANDBOX)",
    "addr1": "19-21, Route d’Arlon",
    "city": "Luxembourg",
    "state": "Strassen",
    "countryName": "Germany",
    "countryCode": "DE",
    "countryCode3": "DEU",
    "postCode": "L-8009",
    "creditorIdentifier": "DE98ZZZ09999999999",
    "contactPhone": "+49 892 488 5811",
    "contactEmail": "test.user.002@kontocloud.com",
    "partnerReference": "DEV-SVR001-DE_CUSTID-T8933PXJPK_CARTID-DJ7JKK662D_FK8K3MPJBQ",
    "localDate": "2018-10-24",
    "localTime": "093028",
    "sysDate": "2018-10-24",
    "sysTime": "073028",
    "responseCode": "0000",
    "responseDescription": "Successful execution"
}

2. Initiate Authorization

3. Collect Payment Option Details via SDK

4. SEPA Mandate Acceptance Page

Each mandate must include certain mandatory legal wording and mandatory information. The page contains not only the details of customer (name, address, etc.) and creditor information (see 1. Get Financial Institution Data), but also the mandate parameters (mandate reference number, date, time). You must display the following standard authorization text (replacing {FI name} with the name of the creditor) clearly visible and close to the accept button.

We suggest to display the mandate in a modal window as depicted in the mockup below.

With accepting the SEPA Mandate, the customer authorizes you to collect a payment for the specified amount from their bank account using SEPA Direct Debit and is redirected to the specified “callbackURL”.

5. Complete Authorization

Note, that the 1.39 Complete Authorize response includes the internal representation of the Account Number (indicated by the parameter Account Number Type).

The response includes the Transaction Status under the return parameter "statusCode", which at this point should be set to "AUTHORIZED" and indicates that the payment was authorized.