plaid-fintech

Skill zawiera sprawdzone praktyki do pracy z API Plaid dla aplikacji finansowych. Znajdziesz tu wzorce do tworzenia tokenów Link, synchronizacji transakcji, weryfikacji tożsamości użytkowników, autoryzacji ACH oraz obsługi webhooków. Dokumentacja obejmuje też best practices dotyczące bezpieczeństwa i zgodności regulacyjnej. Użyj tego skilla, gdy integrujesz łączenie kont bankowych, agregację rachunków lub przetwarzanie płatności ACH.

1. Zainstaluj skill plaid-fintech w swoim projekcie Claude/Copilot, dodając go do listy dostępnych umiejętności agenta.

2. Zacznij od tworzenia link_token – to krótkotrwały token jednorazowy, który umożliwia użytkownikowi połączenie konta bankowego przez interfejs Plaid Link. Po uzyskaniu public_token od użytkownika wymień go na access_token, który będzie przechowywany bezpiecznie po stronie serwera.

3. Do pobierania transakcji użyj endpointu /transactions/sync zamiast /transactions/get – jest bardziej efektywny dla aktualizacji inkrementalnych. Zamiast ciągłego odpytywania (polling), skonfiguruj webhooks do otrzymywania powiadomień o nowych transakcjach w czasie rzeczywistym.

4. Obsługuj błędy typu ITEM_LOGIN_REQUIRED, kierując użytkownika do trybu aktualizacji Link. Nasłuchuj webhooków PENDING_DISCONNECT, aby proaktywnie poinformować użytkownika o konieczności ponownego uwierzytelnienia.

5. Pamiętaj o kluczowych zakazach: nigdy nie przechowuj access_tokenów w postaci zwykłego tekstu, nie polegaj na polingu zamiast webhooków oraz zawsze obsługuj błędy elementów (items). Te praktyki zapobiegają stratom danych i problemom bezpieczeństwa.