Menu

Polecenie zapłaty SEPA

blank

Polecenie zapłaty SEPA jest instrumentem płatniczym umożliwiającym realizację transakcji polecenia zapłaty w euro w strefie Jednolitego Obszaru Płatności w Euro (SEPA). Upraszcza transakcje w euro w całej Unii Europejskiej.

blank
Krok 1: Dane klienta
blank
Krok 2: Przesłanie polecenia
Polecenie zapłaty SEPA – desktopowy interfejs użytkownika.

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.

Polecenie zapłaty SEPA obsługuje dwa schematy: CORE (dla konsumentów indywidualnych) oraz B2B (dla transakcji biznesowych). Wybór odpowiedniego schematu zależy od produktu finansowego aktywowanego dla danego sprzedawcy.

Polecenie zapłaty SEPA jest obsługiwane w następujących krajach:

SEPA DD CORESEPA DD B2B
AustriaAustria
BelgiaBelgia
Czechy–
Dania–
Estonia–
Finlandia–
FrancjaFrancja
NiemcyNiemcy
IrlandiaIrlandia
WłochyWłochy
Łotwa–
Litwa–
HolandiaHolandia
Norwegia–
PolskaPolska
PortugaliaPortugalia
HiszpaniaHiszpania
SzwecjaSzwecja
Wielka BrytaniaWielka Brytania

Jak korzystać z polecenia zapłaty SEPA

Polecenia zapłaty SEPA wykorzystuje proces weryfikacji „konto do konta”, umożliwiając dłużnikom autoryzację poleceń zapłaty bezpośrednio w bankowości internetowej i eliminując konieczność ręcznego wpisywania IBAN ani przesyłania podpisanych mandatów.

Krok 1: Wybierz lokalizację banku i język

Po wybraniu SEPA Direct Debit podczas finalizacji zakupu użytkownik zostanie poproszony o wskazanie kraju banku oraz preferowanego języka. Dzięki temu lista banków jest dostosowana do regionu użytkownika.

Krok 2: Autoryzacja weryfikacji konta

Przed kontynuacją użytkownik musi zaznaczyć pole potwierdzające, że wyraża zgodę na utworzenie mandatu SEPA DD. Następnie należy kliknąć „Kontynuuj”, aby przejść dalej.

Krok 3: Wybierz swój bank

Na podstawie kraju i języka wybranego w Kroku 1 zostanie wyświetlona lista dostępnych banków. Użytkownik powinien wybrać swój bank, aby rozpocząć proces weryfikacji konta.

Krok 4: Weryfikacja konta przez bankowość internetową

Użytkownik zostanie przekierowany do aplikacji lub strony internetowej banku, aby zalogować się i zweryfikować konto. Jeśli posiada kilka kont, będzie mógł wybrać, którego użyć. Po uwierzytelnieniu dane konta użytkownika (takie jak IBAN i nazwa właściciela konta) zostaną bezpiecznie pobrane.

Krok 5: Przejrzyj wstępnie wypełnione dane mandatu

Po pomyślnej weryfikacji użytkownik zostanie przekierowany z powrotem do formularza płatności, w którym automatycznie wyświetlą się dane pobrane z banku (nazwa, dane konta itp.). Te pola nie mogą być edytowane.

Krok 6: Pobierz i prześlij mandat

PDF mandatu jest automatycznie generowany na podstawie zweryfikowanych danych konta. Na stronie szczegółów mandatu dostępny jest przycisk „Pobierz mandat”, dzięki któremu użytkownik może zapisać kopię mandatu na swoim urządzeniu jako dowód jego utworzenia. Następnie użytkownik może kliknąć „Wyślij mandat”, aby zakończyć proces tworzenia mandatu.

Dodatkowy krok dla SEPA DD B2B

W przypadku mandatów B2B, po pobraniu PDF mandatu użytkownik musi również podpisać pobrany mandat i przesłać podpisany plik za pomocą przycisku „Prześlij mandat”. Akceptowane formaty to PDF, JPEG i PNG (maks. 1 MB).

Mandaty w formacie PDF są przechowywane w systemie SIBS Backoffice, a sprzedawcy mogą pobierać je w dowolnym momencie.

Info

Aby rozpocząć przyjmowanie płatności za pomocą polecenia zapłaty SEPA, skontaktuj się ze swoim Opiekunem Klienta.

Jak to działa

Poniżej znajdziesz szczegółowy opis kroków niezbędnych do wdrożenia polecenie zapłaty SEPA:

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:

Uruchom w Postmanie
LokalizacjaElement danychTypStanOpis
Treść żądaniazleceniezlecenieOpcjonalnieInformacje o szczegółach mandatu
Request Body.mandatemandateIdCiągWymaganeIdentyfikacja zasobu zezwolenia na polecenie zapłaty.
Odnosi się do numeru autoryzacji polecenia zapłaty.
Max35Text
Request Body.mandatemandateDescriptionCiągWymaganeOpis kontekstu zasobu upoważniającego do polecenia zapłaty.
Max256Text
Request Body.mandateczęstotliwośćCiągOpcjonalnieRegularność, z jaką instrukcje mają być tworzone i przetwarzane.

„OOFF” – „One-Off” (Instrukcja polecenia zapłaty, w której za zgodą dłużnika inicjuje się jedną pojedynczą transakcję polecenia zapłaty)

„RCUR” – „Recurring” (Instrukcja polecenia zapłaty, w przypadku której wykorzystuje się autoryzację dłużnika do regularnych transakcji polecenia zapłaty inicjowanych przez wierzyciela)

Exact4Text
Request Body.mandateserviceType ServiceTypeCodeWymaganeIdentyfikacja usługi Polecenia Zapłaty SEPA powiązanej z konkretnym Zleceniem Polecenia Zapłaty.

Można to spełnić przy pomocy następujących wartości:
„CORE” w przypadku usługi SEPA DD CORE;
„BTOB” w przypadku usługi SEPA DD B2B.

Exact4Text
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

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:
ŚrodowiskoURLMetoda działania i endpointyOpis działania
PRODapi.sibsgateway.comPOST {version-id}/{id}/mandates/sepaddTworzy zasób upoważnienia SEPA DD określony w żądaniu.
TESTstargate.qly.site[1|2].sibs.ptPOST {version-id}/{id}/mandates/sepaddTworzy zasób upoważnienia SEPA DD określony w żądaniu.

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

LokalizacjaElement danychTypStanOpis
PathidCiągWymaganeSłuży do identyfikacji transakcji
Parametry nagłówka:
LokalizacjaElement danychTypStanOpis
Nagłówek żądaniaContent-TypeCiągWymaganeapplication/json
Nagłówek żądaniaAutoryzacjaCiągWymaganePodsumowanie autoryzacji
Parametry żądania:
LokalizacjaElement danychTypStanOpis
Treść żądaniauserAcceptanceIndicatorWartość logicznaWymaganeWskazuje, czy użytkownik zaakceptował Regulamin w celu kontynuowania płatności.
Request Body.infodeviceInfoDeviceInfoWymaganeObiekt definiujący informacje o urządzeniu klienta.
Request Body.info.deviceInfobrowserAcceptHeaderciągOpcjonalnieBrowser Accept Header
Request Body.info.deviceInfobrowserJavaEnabledciągOpcjonalnieBrowser Java Enabled
Request Body.info.deviceInfobrowserLanguageciągOpcjonalniebrowser Language
Request Body.info.deviceInfobrowserColorDepthciągOpcjonalnieGłębia kolorów przeglądarki
Request Body.info.deviceInfobrowserScreenHeightciągOpcjonalnieWysokość ekranu przeglądarki
Request Body.info.deviceInfobrowserScreenWidthciągOpcjonalnieSzerokość ekranu przeglądarki
Request Body.info.deviceInfobrowserTZciągOpcjonalnieStrefa czasowa przeglądarki
Request Body.info.deviceInfobrowserUserAgentciągOpcjonalnieAgent użytkownika przeglądarki
Request Body.info.deviceInfosystemFamilyciągOpcjonalnieRodzina systemowa
Request Body.info.deviceInfosystemVersionciągOpcjonalnieWersja systemu
Request Body.info.deviceInfosystemArchitectureciągOpcjonalniearchitektura systemu
Request Body.info.deviceInfodeviceManufacturerciągOpcjonalnieProducent urządzenia
Request Body.info.deviceInfodeviceModelciągOpcjonalnieModel urządzenia
Request Body.info.deviceInfodeviceIDciągOpcjonalnieUnikalna identyfikacja urządzenia
Request Body.info.deviceInfoapplicationNameciągOpcjonalnieNazwa aplikacji
Request Body.info.deviceInfoapplicationVersionciągOpcjonalnieWersja aplikacji
Request Body.info.deviceInfogeoLocalizationciągOpcjonalnieGeolokalizacja
Request Body.info.deviceInfoipAddressciągOpcjonalnieAdres IP
Treść żądaniazleceniezlecenieWymaganeMandate information
Request Body.mandatemandateIdCiągWymaganeIdentyfikacja zasobu zezwolenia na polecenie zapłaty.
Odnosi się do numeru autoryzacji polecenia zapłaty.

Max35Text
Request Body.mandatemandateDescriptionCiągWymaganeOpis kontekstu zasobu upoważniającego do polecenia zapłaty.

Max256Text
Request Body.mandateczęstotliwośćFrequencyTypeCodeWymaganeRegularność, z jaką instrukcje mają być tworzone i przetwarzane.
„OOFF” – „One-Off” (Instrukcja polecenia zapłaty, w której za zgodą dłużnika inicjuje się jedną pojedynczą transakcję polecenia zapłaty)

„RCUR” – „Recurring” (Instrukcja polecenia zapłaty, w przypadku której wykorzystuje się autoryzację dłużnika do regularnych transakcji polecenia zapłaty inicjowanych przez wierzyciela)

Exact4Text
Treść żądaniacreditorcreditorWymaganeInformacje o wierzycielu
Request Body.creditorcreditorIdCiągWymaganeIdentyfikacja Wierzycieli, m.in. identyfikator wierzyciela SEPA.

Max35Text
Treść żądaniadłużnikdłużnikWymaganeInformacje o dłużniku
Request Body.debtorcustomerFullNameCiągWymaganeImię i nazwisko klienta.

Max140Text
Request Body.debtorcustomerEmailCiągWymaganeEmail klienta.

Max255Text
Request Body.debtorcustomerAddressCiągWymaganeAdres klienta.

Max140Text
Request Body.debtorcustomerAddressPostalCodeCiągWymaganeKod pocztowy adresu klienta.

Max16Text
Request Body.debtorcustomerAddressCityCiągWymaganeMiasto adresu klienta.

Max35Text
Request Body.debtorcustomerAddressCountryCiągWymaganeKraj adresu klienta.

ISO Alpha2
Request Body.debtordebtorAccountNumer kontaWymaganeInformacje o koncie dłużnika
Request Body.debtor.debtorAccountibanIBANWymaganeMiędzynarodowy numer rachunku bankowego (dłużnika).

Max34Text (IBAN ISO13616)
Request Body.debtor.debtorAccountdebtorAgentBICFIOpcjonalnieIdentyfikacja Wierzyciela (BIC SWIFT).

Max11Text

ISO9362 format
Request Body.debtor.debtorAccountconfirmationFilePlik binarnyWymaganeDokument potwierdzający posiadanie konta (dowód posiadania konta – plik certyfikatu).

1MB Binary File
Request Body.debtor.debtorAccountfileContentTypeCiągWymaganeTyp zawartości pliku
Możliwa wartość:
application.jpeg
application.png
application.pdf
Request Body.debtorcustomerSignatureCiągWymaganeDane podpisu klienta
Request Body.debtor.customerSignaturelocalCiągWymaganePodpis klienta lokalny.

Max35Text
Request Body.debtor.customerSignaturedataISODateWymaganeData podpisu klienta

ISODate
Request Body.debtor.customerSignatureimagePlik binarnyWymaganeObraz podpisu klienta.

1MB Binary File
Request Body.debtor.customerSignaturefileContentTypeCiągWymaganeTyp zawartości obrazu
Możliwa wartość:
application.jpeg
application.tiff
application.png
application.gif

Oto przykład tworzenia zlecenia:

Uruchom w Postmanie
{
    "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:
ŚrodowiskoURLMetoda działania i endpointyOpis działania
PRODapi.sibsgateway.comPOST {version-id}/payments/{id}/sepa/payment-linkPrzeprowadzenie transakcji i przekierowanie użytkownika do hosta płatności.
TESTstargate.qly.site[1|2].sibs.ptPOST {version-id}/payments/{id}/sepa/payment-linkPrzeprowadzenie transakcji i przekierowanie użytkownika do hosta płatności.

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

LokalizacjaElement danychTypStanOpis
PathidCiągWymaganeSłuży do identyfikacji transakcji
Parametry nagłówka:
LokalizacjaElement danychTypStanOpis
Nagłówek żądaniaContent-TypeCiągWymaganeapplication/json
Nagłówek żądaniaAutoryzacjaCiągWymaganePodsumowanie autoryzacji
Parametry żądania:
LokalizacjaElement danychTypStanOpis
Treść żądaniauserAcceptanceIndicatorWartość logicznaWymaganeWskazuje, czy użytkownik zaakceptował Regulamin w celu kontynuowania płatności.
Treść żądaniagatewayIdCiągWymaganeIdentyfikator kanału płatności dla kanału, którego klient zamierza użyć do dokonania płatności.
Możliwe wartosci to:
’ideal’ – iDEAL;
Treść żądaniainfoInfoWymaganeObiekt definiujący dodatkowe informacje o transakcji.
Request Body.infodeviceInfoDeviceInfoOpcjonalnieObiekt definiujący informacje o urządzeniu klienta.
Request Body.info.deviceInfobrowserAcceptHeaderciągOpcjonalnieBrowser Accept Header
Request Body.info.deviceInfobrowserJavaEnabledciągOpcjonalnieBrowser Java Enabled
Request Body.info.deviceInfobrowserLanguageciągOpcjonalniebrowser Language
Request Body.info.deviceInfobrowserColorDepthciągOpcjonalnieGłębia kolorów przeglądarki
Request Body.info.deviceInfobrowserScreenHeightciągOpcjonalnieWysokość ekranu przeglądarki
Request Body.info.deviceInfobrowserScreenWidthciągOpcjonalnieSzerokość ekranu przeglądarki
Request Body.info.deviceInfobrowserTZciągOpcjonalnieStrefa czasowa przeglądarki
Request Body.info.deviceInfobrowserUserAgentciągOpcjonalnieAgent użytkownika przeglądarki
Request Body.info.deviceInfosystemFamilyciągOpcjonalnieRodzina systemowa
Request Body.info.deviceInfosystemVersionciągOpcjonalnieWersja systemu
Request Body.info.deviceInfosystemArchitectureciągOpcjonalniearchitektura systemu
Request Body.info.deviceInfodeviceManufacturerciągOpcjonalnieProducent urządzenia
Request Body.info.deviceInfodeviceModelciągOpcjonalnieModel urządzenia
Request Body.info.deviceInfodeviceIDciągOpcjonalnieUnikalna identyfikacja urządzenia
Request Body.info.deviceInfoapplicationNameciągOpcjonalnieNazwa aplikacji
Request Body.info.deviceInfoapplicationVersionciągOpcjonalnieWersja aplikacji
Request Body.info.deviceInfogeoLocalizationciągOpcjonalnieGeolokalizacja
Request Body.info.deviceInfoipAddressciągOpcjonalnieAdres IP
Treść żądaniasprzedawcaSprzedawcaOpcjonalnieDane sprzedawcy
Request Body.merchantmerchantURLciągWymaganeAdres URL sklepu sprzedawcy do przekierowania.
Request Body.merchantappToAppURLciągOpcjonalnieNiestandardowy adres URL aplikacji do przekierowania klienta z powrotem do aplikacji, co spowodowało płatność.
Request Body.infoaccountInfoInformacje o koncieOpcjonalnieDane związane z kontem.
Ma zastosowanie, gdy GatewayId jest „idealny”.
Request Body.info.accountInfoholderNameCiągOpcjonalnieNazwa właściciela konta. UTF-8 Format. Max100Text
Request Body.info.accountInfocustomerCountryCiągOpcjonalnieKod kraju klienta. Alpha2
Treść żądaniatransactionalScopeCiągWymaganeIdentyfikacja konkretnego zakresu transakcyjnego żądania Payment Link.

Możliwa wartość:
’SPDD’ (SEPA Direct Debits)

Exact4Text
Treść żądaniazleceniezlecenieWarunkowyWystępuje tylko wtedy, gdy zakres transakcyjny ma wartość „SPDD” (polecenie zapłaty SEPA)

Mandate information
Request Body.mandatemandateIdCiągWymaganeIdentyfikacja zasobu zezwolenia na polecenie zapłaty.
Odnosi się do numeru autoryzacji polecenia zapłaty.

Max35Text
Request Body.mandatemandateDescriptionCiągWymaganeOpis kontekstu zasobu upoważniającego do polecenia zapłaty.

Max256Text
Request Body.mandateczęstotliwośćFrequencyTypeCodeWymaganeRegularność, z jaką instrukcje mają być tworzone i przetwarzane.
„OOFF” – „One-Off” (Instrukcja polecenia zapłaty, w której za zgodą dłużnika inicjuje się jedną pojedynczą transakcję polecenia zapłaty)

„RCUR” – „Recurring” (Instrukcja polecenia zapłaty, w przypadku której wykorzystuje się autoryzację dłużnika do regularnych transakcji polecenia zapłaty inicjowanych przez wierzyciela)

Exact4Text
Treść żądaniacreditorcreditorWymaganeInformacje o wierzycielu
Request Body.creditorcreditorIdCiągWymaganeIdentyfikacja Wierzycieli, m.in. identyfikator wierzyciela SEPA.

Max35Text
Treść żądaniadłużnikdłużnikWymaganeInformacje o dłużniku
Request Body.debtorcustomerFullNameCiągWymaganeImię i nazwisko klienta.

Max140Text
Request Body.debtorcustomerEmailCiągWymaganeEmail klienta.

Max255Text
Request Body.debtorcustomerAddressCiągWymaganeAdres klienta.

Max140Text
Request Body.debtorcustomerAddressPostalCodeCiągWymaganeKod pocztowy adresu klienta.

Max16Text
Request Body.debtorcustomerAddressCityCiągWymaganeMiasto adresu klienta.

Max35Text
Request Body.debtorcustomerAddressCountryCiągWymaganeKraj adresu klienta.

ISO Alpha2
Treść żądaniaterminalCodeLiczba całkowitaWymaganeKod terminala

MaxInclusive value=”999999999″

Oto przykład, jak utworzyć zlecenie za pomocą iDeal:

Uruchom w Postmanie
{
    "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żesz wykonać operację „Uzyskaj status”, aby sprawdzić status.
W rezultacie otrzymasz TokenValue, który zostanie wykorzystany w kolejnych krokach.

Nagłówek HTTP autoryzacji jest ustawiony na token okaziciela, tak jak był używany podczas początkowej realizacji transakcji.

GET {transactionID}/status
Uruchom w Postmanie
Adres URL żądania:
https://stargate.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 szybkie przekierowanie użytkownika do Hosta płatności.

Krok 3: Przedstaw inkaso polecenia zapłaty SEPA

Operacja SEPA DD Collection polega na odzyskaniu informacji zgromadzonych podczas tworzenia zlecenia pomiędzy Wierzycielem a Dłużnikiem.

Interfejs, do którego ma mieć dostęp Akceptant, umożliwiający wykonanie operacji bieżącego odbioru polecenia zapłaty SEPA za pośrednictwem bramki płatniczej SIBS, z wykorzystaniem interfejsu API.

Po zainicjowaniu Present SEPA DD Collection pobierane są informacje zapisane podczas tworzenia pełnomocnictwa dotyczącego Wierzyciela i Dłużnika. Otrzymana odpowiedź wskazuje status transakcji.

Punkty końcowe:
ŚrodowiskoURLMetoda działania i endpointyOpis działania
PRODapi.sibsgateway.comPOST {version-id}/mandates/{token-id}/sepadd/collectŻąda danych zarejestrowanych przy tworzeniu zlecenia przy użyciu metody SEPA DD Collection.
TESTstargate.qly.site[1|2].sibs.ptPOST {version-id}/mandates/{token-id}/sepadd/collectŻąda danych zarejestrowanych przy tworzeniu zlecenia przy użyciu metody SEPA DD Collection.

Pamiętaj, aby uwzględnić następujące istotne elementy zgodnie z instrukcją:

LokalizacjaElement danychTypStanOpis
Pathtoken-idCiągWarunkowyIdentyfikator transakcji
Parametry nagłówka:
LokalizacjaElement danychTypStanOpis
Nagłówek żądaniaContent-TypeCiągWymaganeapplication/json
Nagłówek żądaniaupoważnienieCiągWymaganeToken okaziciela. W oparciu o uwierzytelnianie OAuth2 wykonywane w kroku wstępnym.
Nagłówek żądaniax-ibm-client-idCiągWymaganeToken identyfikujący organizację klienta. Jest on dostarczany podczas procesu wdrażania i musi być używany w każdym połączeniu.
Parametry żądania:
LokalizacjaElement danychTypStanOpis
Treść żądaniainfoInfoWymaganeObiekt definiujący dodatkowe informacje o transakcji.
Request Body.infocustomDatacustomDataWymaganeTablica krotek wartości klucza.
Request Body.info.customDatakluczciągOpcjonalnie
Request Body.info.customDatawartośćciągOpcjonalnie
Treść żądaniasprzedawcasprzedawcaWymaganeObiekt definiujący merchanta.
Request Body.merchantterminalIdciągWymaganeIdentyfikacja Terminala merchanta.

Maximum length is 10.
Request Body.merchantmerchantTransactionIdciągWymaganeUnikalny identyfikator używany przez sprzedawcę.

Maksymalna długość to 35.
Request Body.merchanttransactionDescriptionciągOpcjonalnieKrótki opis transakcji sprzedawcy.

Maksymalna długość to 256.
Treść żądaniazleceniezlecenieWymaganeSzczegółowe dane dotyczące istniejącego zlecenia pomiędzy wierzycielem a dłużnikiem.
Request Body.mandatetokenIdciągWymaganeWartość tokenu powiązana z identyfikatorem zlecenia.

Maksymalna długość to 35.
Request Body.mandatekwotakwotaWymaganeParametr z wartością i walutą transakcji.
Request Body.mandate.amountwartośćliczba (podwójna)WymaganeKwota do zebrania.
Request Body.mandate.amountwalutacurrencyCodeWymaganeWaluta użyta w transakcji.

ISO 4217 Alpha-3 Code.
Request Body.mandatedueDateciągWymaganeTermin odbioru.

Data.

Oto przykład wykonania kolekcji zleceń:

Uruchom w Postmanie
{
    "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 na zbiórkę SEPA DD.

Krok 4: Uzyskaj szczegóły tokena SEPA DD

Dodatkowo powinieneś wykonać operację „Uzyskaj szczegóły tokenu” zgodnie z poniższymi informacjami, aby w dowolnym momencie sprawdzić informacje dotyczące upoważnienia:

GET version-id/token/details
Uruchom w Postmanie
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 także „status” tokena, który może mieć różne wartości, jak pokazano w poniższej tabeli.

Token „status”Krótki opis „statusu” tokena
INTTZapoczątkowany
PDNGw trakcie
ACTVAktywny
INCTNieaktywny
SSPNZawieszony
EXPRWygasły
CNCLOdwołany
RJCTOdrzucony
RFSDOdrzucony

On this page:

Przegląd prywatności
blank

Ta strona korzysta z ciasteczek, aby zapewnić Ci najlepszą możliwą obsługę. Informacje o ciasteczkach są przechowywane w przeglądarce i wykonują funkcje takie jak rozpoznawanie Cię po powrocie na naszą stronę internetową i pomaganie naszemu zespołowi w zrozumieniu, które sekcje witryny są dla Ciebie najbardziej interesujące i przydatne.

Ściśle niezbędne ciasteczka

Niezbędne ciasteczka powinny być zawsze włączone, abyśmy mogli zapisać twoje preferencje dotyczące ustawień ciasteczek.