Pierwsze kroki w wirtualnym środowisku testowym (Sandbox) Citi Partner Portal

Dostęp do Sandbox’a Citi Partner Portal jest publiczny, co oznacza, że każdy może się w nim zarejestrować i w bezpiecznym środowisku przeprowadzić testową integrację ze swoją aplikacją.

Nasz Sandbox możliwie najwierniej oddaje strukturę środowiska produkcyjnego, dlatego ewentualna migracja do środowiska produkcyjnego powinna odbyć się bez większych problemów. Poniżej instrukcja jak to zrobić:

1. Zarejestruj się na stronie Citi Partner Portal. W ciągu kilku dni otrzymasz maila z potwierdzeniem rejestracji i prośbą o potwierdzenie adresu mailowego przez kliknięcie linka rejestracyjnego.
   Ważne! Rejestracja nie jest wymagana w przypadku TPP korzystającego z otwartych API, w zakresie zgodnym z PSD2.
2. Zaloguj się do Sandbox’a.
3. Zarejestruj swoją aplikację (Register a New App) w sekcji API Keys.
4. Kiedy aplikacja jest zarejestrowana, otrzymasz Client ID oraz Client Secret (są to dane poufne i zgodnie z Regulaminem Sandbox’a nie można ich nikomu udostępniać).
   1. Client ID to identyfikator, który służy nam do określenia kto próbuje uzyskać dostęp do API.
   2. Client Secret – to identyfikator służący do autentykacji i jest wykorzystywany w procesie autoryzacji zapytań wysyłanych poprzez API.
      Ważne! W celu skorzystania z otwartych API, TPP nie musi rejestrować swojej aplikacji. Szczegóły dotyczące integracji z otwartymi API dostępne są w katalogu API na Citi Partner Portal, w zakładce „Poland”.
5. Dokonaj autentykacji poprzez Authorize API z wykorzystaniem Client ID oraz Client Secret. Sandbox wykorzystuje powszechnie stosowany standard OAuth 2.0. W zależności od API, z którym zamierzasz się zintegrować, istnieją dwa sposoby autentykacji:
   1. Two-Legged – wykorzystywana w sytuacji, gdy Bank nie przekazuje do aplikacji podmiotu trzeciego danych wrażliwych lub poufnych (np. Onboarding API)
   2. Three-Legged – wykorzystywana w sytuacji, gdy Bank przekazuje do aplikacji podmiotu trzeciego dane wrażliwe lub poufne (np. w zakresie usług AIS/PIS – czyli dostęp do informacji o rachunku lub inicjacja płatności)
      Ważne! Szczegóły dotyczące autoryzacji TPP dostępne są w katalogu API na Citi Partner Portal, w zakładce „Poland”.
6. Dokonaj właściwej integracji swojej aplikacji z API Banku z wykorzystaniem zamieszczonej na Sandbox’ie dokumentacji. Sandbox umożliwia generowanie statycznych odpowiedzi na wysłane żądania API.
7. Po pomyślnym przeprowadzeniu testów, prosimy o wysłanie zgłoszenia do Banku z propozycją współpracy. Zgłoszenie można wysłać używając danych kontaktowych znajdujących się na tej stronie lub poprzez formularz kontaktowy na Citi Partner Portal.

Dostępne kategorie API

W ramach Citi Partner Portal dla Polski dostępne są następujce kategorie API (w menu głównym wybierz API Products > Poland):

1. Informacje o rachunkach (Accounts) – dostęp do informacji o rachunkach płatniczych (konta bieżące, oszczędnościowe, walutowe oraz karty kredytowe) w zakresie salda, historii transakcji oraz szczegółów rachunku.
   Ważne! To API może być wykorzystane przez TPP w celu świadczenia usług AIS oraz CAF
2. Autoryzacja (Authorize) – pozwala zweryfikować klienta Citi Handlowy.
3. Dane Klienta (Customers) – podstawowe dane dot. Klienta.
4. Inicjacja płatności (Money Movement) – pozwala inicjować przelewy dostępne dla klientów Citi Handlowy, w tym darmowy i natychmiastowy przelew pomiędzy kontami Citi w różnych krajach (CGT – Citi Global Transfer).
   Ważne! To API może być wykorzystane przez TPP w celu świadczenia usługi PIS
5. Akwizycja (Onboarding) – możliwość wysyłania do Citi Handlowy wniosków o karty kredytowe i pożyczki gotówkowe. Mogą to być tzw. krótkie wnioski zawierające podstawowe informacje o kliencie, jak również tzw. Długie wnioski - pełen proces aplikacyjny obejmujący wszystkie dane klienta, wstępną decyzję kredytową, dokumentację oraz weryfikację klienta.
6. Płać punktami Citi (Pay with Points) – używanie punktów Citi do płatności online.
7. Narzędzia (Utilities) – informacje dot. wartości, które mogą przyjmować niektóre API.

Raporty dostępności API

Poniżej znajdują się publikowane kwartalnie raporty z informacjami o dostępności dedykowanego interfejsu dostępowego, czyli naszego API funkcjonującego w ramach usług PSD2.

W raporcie znajdują się następujące dzienne dane odnośnie wydajności naszego API: dostępność, niedostępność, średnie czasy odpowiedzi i procent błędnych odpowiedzi.