Połącz własne systemy z TransferGo i automatycznie pobieraj historię transakcji — nie musisz się logować, aby to sprawdzić.
Czym jest Biznesowe API TransferGo i co mogę dzięki niemu zrobić?
Wprowadzamy nowy sposób na połączenie z TransferGo: Biznesowe API. Pozwala to Twojej firmie na pobieranie historii transakcji bezpośrednio z własnych systemów — bez konieczności logowania się do portalu za każdym razem, gdy chcesz sprawdzić swoje płatności.
Jest to szczególnie przydatne, jeśli:
- Regularnie uzgadniasz płatności: pobierasz dane o transakcjach prosto do własnego oprogramowania księgowego lub systemu ERP (Planowanie Zasobów Przedsiębiorstwa).
- Posiadasz zespół programistów: połącz się raz i pozwól swoim systemom wykonywać sprawdzanie za Ciebie.
W tej chwili funkcja ta obejmuje wyłącznie przeglądanie historii aktywności na koncie. Możliwość wysyłania płatności za pośrednictwem interfejsu API pojawi się w dalszej części tego roku — powiadomimy Cię, gdy będzie gotowa.
Aby uzyskać pełny obraz możliwości tego interfejsu API, zapoznaj się z dokumentacją dla programistów.
Jak rozpocząć łączenie moich systemów z Biznesowym API TransferGo?
- Otwórz Integracje API: Zaloguj się do TransferGo Business i kliknij Integracje API w menu po lewej stronie.
- Rozpocznij łączenie: Kliknij „Wyrażam zgodę” i utwórz połączenie API.
- Zaakceptuj warunki: Utworzenie połączenia API wymaga zaakceptowania naszego zaktualizowanego Regulaminu.
Nie jesteś właścicielem konta? Nie będziesz w stanie samodzielnie potwierdzić tego kroku — sprawdź w następnym artykule, co należy zrobić.
Zatwierdzanie połączenia API jako właściciel konta
Jeśli członek zespołu rozpocznie konfigurację połączenia API, ale nie jest właścicielem konta, będzie potrzebował Twojego zatwierdzenia, zanim zostanie ono uruchomione.
- Odbierz link z potwierdzeniem: Członek Twojego zespołu wyśle Ci link w celu potwierdzenia połączenia.
- Przejrzyj i zaakceptuj: Otwórz link i zaakceptuj zaktualizowany Regulamin.
- Gotowe: Po potwierdzeniu członek zespołu może kontynuować konfigurację certyfikatu i łączenie systemów.
Jak wygenerować certyfikat i nawiązać połączenie?
Po potwierdzeniu połączenia skonfigurujesz certyfikat klienta, który umożliwi Twoim systemom bezpieczne łączenie się, a następnie wykorzystasz go do uzyskania tokenu dostępu.
Najważniejsze informacje:
- Twój klucz prywatny jest generowany na Twoim komputerze i nigdy go nie opuszcza.
- Certyfikaty są ważne przez 1 rok.
- Tokeny dostępu są ważne przez 5 minut, dlatego warto je buforować i ponownie wykorzystywać, zamiast żądać nowych przy każdym wywołaniu.
- Przesyłanie żądania podpisania certyfikatu (CSR) jest wrażliwym etapem, dlatego zostaniesz poproszony o potwierdzenie tej czynności hasłem.
Jak to zrobić:
- Otwórz sekcję Integracje API i postępuj zgodnie z instrukcją Jak się połączyć dla swojego systemu operacyjnego (Windows lub macOS/Linux).
- Postępuj zgodnie z wyświetlanymi instrukcjami, aby wygenerować certyfikat, a następnie uzyskać token dostępu i przetestować połączenie.
Utknąłeś w trakcie? Na ekranie konfiguracji znajduje się link „Potrzebuję pomocy”.
Aby uzyskać dokładne polecenia, szczegóły certyfikatu i żądania tokenów, zapoznaj się z przewodnikiem „Uwierzytelnianie i autoryzacja”.
Jak zarządzać swoimi certyfikatami API?
W sekcji „Integracje API” możesz w dowolnym momencie zarządzać swoimi certyfikatami.
A. Pobieranie certyfikatu
- Przejdź do integracji API.
- Znajdź swój certyfikat w tabeli i kliknij Pobierz .CRT.
B. Dodawanie certyfikatu dodatkowego
- Przejdź do integracji API.
- Kliknij Dodaj certyfikat dodatkowy.
Jest to przydatne, jeśli chcesz mieć gotowy certyfikat zapasowy, zanim wygaśnie Twój główny certyfikat.
C. Unieważnianie certyfikatu
- Przejdź do integracji API.
- Znajdź certyfikat, który chcesz usunąć, i kliknij ikonę unieważnienia obok niego.
- Potwierdź usunięcie.
Po unieważnieniu taki certyfikat nie może być już używany do nawiązywania połączenia — przed unieważnieniem upewnij się, że Twoje systemy z niego nie korzystają.
Najważniejsza informacja: certyfikaty są ważne przez 1 rok. Aby przeprowadzić rotację bez przestoju, należy dodać certyfikat rezerwowy przed upływem terminu ważności certyfikatu głównego, przełączyć systemy na certyfikat rezerwowy, a następnie unieważnić certyfikat główny.
Więcej informacji na temat wygaśnięcia i rotacji certyfikatów można znaleźć w artykule „Wygaśnięcie i rotacja certyfikatów”.
Co mogę pobrać za pomocą Biznesowego API TransferGo?
Po nawiązaniu połączenia możesz pobierać dane dotyczące aktywności na koncie bezpośrednio do swoich systemów. Obejmuje to przelewy i doładowania, a także wymianę walut, wpłaty i wypłaty z rachunków oszczędnościowych, odsetki oraz korekty salda.
Dla każdej transakcji otrzymasz szczegóły, takie jak jej status, data i godzina, kwoty i waluty, opłaty, numery referencyjne oraz dane nadawcy i odbiorcy, przy czym numery kart są zamaskowane ze względów bezpieczeństwa.
Wyniki są podzielone na strony i można je filtrować, dzięki czemu obszerne historie są ładowane w łatwych do opanowania fragmentach.
Na razie jest to funkcja tylko do odczytu: możesz pobierać dane, ale nie możesz jeszcze wysyłać płatności za pośrednictwem API. Ta funkcja ma zostać udostępniona jeszcze w tym roku.
Pełną listę pól, statusów i opcji filtrowania znajdziesz w dokumentacji dotyczącej transakcji.