Polecenie zapłaty SEPA upraszcza transakcje denominowane w euro w całej UE.

SEPA Direct Debit jest instrumentem płatniczym umożliwiającym realizację transakcji polecenia zapłaty w euro w strefie Jednolitego Obszaru Płatności w Euro (SEPA).

Umożliwia wierzycielom procesowanie opłat za pośrednictwem swojej instytucji finansowej w oparciu o autoryzację polecenia zapłaty wydaną wierzycielowi przez dłużnika. Zarówno Dłużnik, jak i Wierzyciel muszą posiadać rachunki w strefie SEPA.

Jak korzystać z SEPA DD

SEPA Direct Debit zapewnia efektywną metodę transakcji na terenie Unii Europejskiej.
Oto przewodnik, jak zrozumieć i wykorzystać ten usprawniony proces płatności:

Krok 1: Wybierz polecenie zapłaty SEPA podczas realizacji transakcji, aby rozpocząć proces płatności.
Krok 2: Wprowadź swoje dane osobowe, w tym imię i nazwisko oraz adres, a także numer IBAN (międzynarodowy numer rachunku bankowego) i podaj autoryzację zlecenia.
Krok 3: Otrzymaj szybkie powiadomienie potwierdzające pomyślne zakończenie transakcji płatniczej.

Jak to działa

Poniżej znajdziesz szczegółowy opis kroków niezbędnych do wdrożenia metody płatności SEPA Direct Debit:

Krok 1: Utwórz zamówienie

Krok 2: Utwórz upoważnienie do polecenia zapłaty SEPA

Krok 3: Przedstaw inkaso polecenia zapłaty SEPA

Krok 4: Uzyskaj szczegóły tokena SEPA DD

Krok 1: Utwórz zamówienie

Rozpocznij składanie zamówienia, wyznaczając polecenie zapłaty SEPA („SPDD”) jako preferowaną metodę płatności (transaction.paymentMethod). Upewnij się, że kwota transakcji (transaction.amount) jest ustawiona na 0. Ponadto pamiętaj o dodaniu obiektu zgodnie z poniższymi instrukcjami:

Krok 2: Utwórz upoważnienie do polecenia zapłaty SEPA

Po zakończeniu procesu tworzenia zamówienia i wybraniu przez klienta metody „SPDD” jako preferowanej opcji płatności, kolejnym krokiem jest wygenerowanie zasobu upoważniającego do polecenia zapłaty SEPA.

Zlecenie to dokument podpisany przez dłużnika, upoważniający wierzyciela do inkasa płatności i umożliwiający bankowi dłużnika realizację tych inkasów.

Ten wybór uruchamia dwie różne opcje tworzenia mandatu:

• Opcja 1: Utwórz zlecenie SEPA DD
• Opcja 2: Utwórz zlecenie SEPA DD z uwierzytelnieniem (przeznaczone dla klientów iDeal)

Opcja 1: Utwórz zlecenie SEPA DD

Proces ten obejmuje utworzenie upoważnienia do polecenia zapłaty SEPA, w którym wymagane są zarówno dane wierzyciela, jak i dłużnika. Klient musi wypełnić wszystkie dane rachunku dłużnika, dostarczyć dokument potwierdzający IBAN i swój podpis. Następnie zlecenie zostaje sfinalizowane i zarejestrowane.

W rezultacie klient ma teraz upoważnienie do polecenia zapłaty SEPA, które jest gotowe do wykorzystania w przyszłości w płatnościach z wykorzystaniem bieżącej operacji windykacyjnej SEPA Direct Debit, zainicjowanej przez Sprzedawcę.

Po omówieniu tego procesu zostaną przedstawione szczegółowe kroki wdrażania utworzenia upoważnienia do polecenia zapłaty SEPA:

Punkty końcowe:

Upewnij się, że uwzględniłeś te kluczowe elementy zgodnie z opisem:

Parametry nagłówka:

Request parameters:

Oto przykład tworzenia zlecenia:

{
 "mandate": {
 "mandateId": "mandateID",
 "mandateDescription": "mandateDescription",
 "frequency": "OOFF",
 "serviceType": "CORE"
 },
 "creditor": {
 "creditorId": "NL89ZZZOP4GBH51AL8LS3DY1QG"
 },
 "debtor": {
 "customerFullName": "Testing Customer Name",
 "customerEmail": "email@provider.com",
 "customerAddress": "Full Address testing",
 "customerAddressPostalCode": "1011AA",
 "customerAddressCity": "TestCity",
 "customerAddressCountry": "NL",
  "debtorAccount": {
 "iban": "NL27TUUk48tlEvz9tk6o9Q6Mxaiyz",
 "confirmationFile": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD/4gxYSUNDX1BST0ZJTEUAAQEAAAxITGlubwIQAABtbnRyUkdCIFhZWiAHzgACAAkABgAxAABhY3NwTVNGVAAAAABJRUMgc1JHQgAAAAAAAAAAAAAAAAAA9tYAAQAAAADTLUhQICAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABFjcHJ0AAABUAAAADNkZXNjAAABhAAAAGx3dHB0AAAB8AAAABRia3B0AAACBAAAABRyWFlaAAACGAAAABRnWFlaAAACLAAAABRiWFlaAAACQAAAABRkbW5kAAACVAAAAHBkbWRkAAACxAAAAIh2dWVkAAADTAAAAIZ2aWV3AAAD1AAAACRsdW1pAAAD
+IlnWeJf4QbwKgtIlfEDb1GjbkJawN1uXWHnqZHsti+BfRKB51NDZaccTKMSx74mWseY2fmGVEV81BaSwOtRXnq8TXFeSFBMcwVPB+Zd06OpovGo4MVrApcXKVfMdwFDms0Ratq2qI20PUvA71iJd9TIMeoETUYKPHUcZcjiJSnWXMcxOeIy84aM5lW9epghC1YxcWrsm1Lc5lKfvNE6l/3caDsTMT5l7cp1LN6xFNxWTzUc24qvxHI80x8be2WKWxs+ZmlGDPuZaPeYGMYzcXVX6qYvXce6OcEtXrjEbz/9k=",
 "fileContentType": "application.jpeg"
 }
 }
}

Opcja 2: Utwórz zlecenie SEPA DD z uwierzytelnieniem (przeznaczone dla klientów iDeal)

Proces ten obejmuje żądanie utworzenia zlecenia SEPA DD z uwierzytelnieniem, wspierającego weryfikację konta Klienta i uwierzytelnienie poprzez przetwarzanie płatności iDEAL (po którym następuje Zwrot płatności iDEAL). Ułatwia to uzupełnienie danych zlecenia, w szczególności danych rachunku dłużnika.

W rezultacie Klient otrzyma upoważnienie SEPA DD, które będzie gotowe do wykorzystania w przyszłości w płatnościach z wykorzystaniem Bieżącej Operacji odbioru SEPA DD, zainicjowanej przez Sprzedawcę.

Aby zainicjować tę operację, należy wykonać łącze API Get SEPA DD Payment Link.

Jak uzyskać łącze do płatności z poleceniem zapłaty SEPA

Konieczne jest pobranie łącza płatniczego SEPA Direct Debit, ponieważ jest ono integralną częścią realizacji transakcji.
Dalsze szczegóły dotyczące tego procesu opisano poniżej:

Punkty końcowe:

Upewnij się, że uwzględniono te istotne elementy, jak określono:

Parametry nagłówka:

Request parameters:

Oto przykład, jak utworzyć upoważnienie za pomocą iDeal:

{
 "terminalCode": {{TerminalIDPPRO}},
 "gatewayId": "ideal",
 "info": {
 "deviceInfo": {
 "browserAcceptHeader": "application/json, text/plain, */*",
 "browserJavaEnabled": "false",
 "browserLanguage": "en",
 "browserColorDepth": "24",
 "browserScreenHeight": "1080",
 "browserScreenWidth": "1920",
 "browserTZ": "-60",
 "browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36",
 "geoLocalization": "Lat: 38.7350528 | Long: -9.2143616",
 "systemFamily": "Windows",
 "systemVersion": "Windows",
 "deviceID": "498bfd4c3a3645b38667a7037b616c18",
 "applicationName": "Chrome",
 "applicationVersion": "106"
 },
 "customerInfo": [
 {
 "key": "customerName",
 "value": "Test Name"
 },
 {
 "key": "customerEmail",
 "value": "email@provider.com"
 }
 ],
 "accountInfo": {
 "holderName": "User",
 "customerCountry": "NL"
 }
 },
 "mandate": {
 "mandateId": "mandateID",
 "mandateDescription": "mandateDescription",
 "frequency": "OOFF",
 "serviceType": "CORE"
 },
 "creditor": {
 "creditorId": "NL89ZZZOP4GBH51AL8LS3DY1QG"
 },
 "debtor": {
 "customerFullName": "Testing Customer Name",
 "customerEmail": "email@provider.com",
 "customerAddress": "Full Address testing",
 "customerAddressPostalCode": "1011AA",
 "customerAddressCity": "TestCity",
 "customerAddressCountry": "NL"
 },
 "merchant": {
 "merchantURL": "https://egadget2.azurewebsites.net/#/returns?id={{transactionId}}"
 },
 "transactionalScope": "SPDD"
}

Następnie można wykonać operację „Get Status”, aby sprawdzić status.
W rezultacie otrzymasz TokenValue, który będzie używany w kolejnych krokach.

Nagłówek HTTP Authorization jest ustawiony na Bearer token, który został użyty w początkowym Checkoucie.

GET {transactionID}/status

Adres URL żądania:

https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/status

Nagłówki żądań:

Authorization: ‘Bearer <AuthToken>’ 
X-IBM-Client-Id: ‘<ClientId>’ 
Content-Type: application/json

Następnie konieczne jest natychmiastowe przekierowanie użytkownika do hosta płatności.

Krok 3: Przedstawienie polecenia zapłaty SEPA

Operacja SEPA DD Collection obejmuje pobieranie informacji przechowywanych podczas tworzenia upoważnienia między wierzycielem a dłużnikiem.

Interfejs, do którego ma dostęp Akceptant, aby umożliwić wykonanie operacji pobrania polecenia zapłaty Present SEPA za pośrednictwem bramki płatniczej SIBS, z wykorzystaniem interfejsu API Frontend.

Gdy inicjowana jest usługa Present SEPA DD Collection, pobierane są informacje zarejestrowane podczas tworzenia upoważnienia obejmującego Wierzyciela i Dłużnika. Wynikowa odpowiedź wskazuje status transakcji.

Punkty końcowe:

Pamiętaj, aby uwzględnić te istotne elementy zgodnie z instrukcjami:

Parametry nagłówka:

Request parameters:

Oto przykład, jak wykonać pobranie upoważnienia:

{
 "merchant": {
 "terminalId": "{{TerminalIDPPRO}}",
 "channel": "web",
 "merchantTransactionId": "7235666",
 "transactionDescription": "transaction short description",
 "shopURL": "https://mytest.e-shop.pl/"
 },
 "mandate": {
 "tokenId": "{{tokenId}}",
 "amount": {
 "value": 1,
 "currency": "EUR"
 },
 "dueDate": "{{dueDate}}"
 },
 "customer": {
 "customerInfo": [
 {
 "key": "customerName",
 "value": "Test Name"
 },
 {
 "key": "customerEmail",
 "value": "email@provider.com"
 }
 ]
 }
}

Wskazanie pomyślnej odpowiedzi technicznej obejmuje status HTTP-200 i „returnStatus.statusCode” o wartości „000” w odpowiedzi SEPA DD Collection Response.

Krok 4: Uzyskaj szczegóły tokena SEPA DD

Dodatkowo należy wykonać operację „Get Token Details”, jak opisano poniżej, aby sprawdzić informacje o mandacie w dowolnym momencie:

GET version-id/token/details

Nagłówki żądań:

Authorization: ‘Bearer <AuthToken>’ 
X-IBM-Client-Id: ‘<ClientId>’ 
Content-Type: application/json 

Wskazanie pomyślnej odpowiedzi SEPA DD Collection obejmuje status HTTP-200. Zawiera również token „status”, który może mieć różne wartości, jak pokazano w poniższej tabeli.