메인 콘텐츠로 건너뛰기
Plaid 커넥터는 유료 Replit 플랜에서 사용할 수 있으며 팀 워크스페이스가 필요합니다.
Plaid는 앱을 금융 기관에 연결합니다. Plaid 커넥터를 사용하면 빌더는 연결된 기관이 지원하는 계정 잔액, 거래, 투자 데이터를 활용하는 앱을 만들 수 있습니다. 설정은 두 부분으로 이루어집니다. 워크스페이스 관리자가 Replit에서 Plaid 자격 증명을 한 번 구성하면, 앱을 사용하는 각 사용자가 Plaid Link를 통해 자신의 금융 계정을 연결합니다. Plaid 접근 토큰은 사용자별로 범위가 지정되어 안전하게 저장되므로, 앱은 Plaid 시크릿을 직접 다루지 않고도 금융 데이터를 사용할 수 있습니다.

빌드할 수 있는 것

Plaid 커넥터를 사용해 다음과 같은 앱을 빌드할 수 있습니다.
  • 개인 재무 대시보드
  • 예산 관리 및 지출 분류 도구
  • 거래 검색 및 분석 앱
  • 지원되는 투자 계정을 위한 포트폴리오 추적기
  • 지출 패턴을 요약하는 재무 코치

사전 준비 사항

Replit에서 Plaid를 구성하기 전에 다음이 필요합니다. Plaid의 샘플 기관과 자격 증명으로 테스트하는 동안에는 sandbox를 사용하세요. 앱이 실제 금융 계정을 연결할 준비가 되면 production을 사용하세요.

Replit에서 Plaid 커넥터 구성하기

워크스페이스 관리자가 Replit에 Plaid 자격 증명을 추가합니다. 커넥터가 구성되면 빌더는 Agent와 함께 Plaid 데이터를 사용할 수 있습니다.
1

Integrations 열기

Replit에서 워크스페이스 또는 앱 설정을 열고 Integrations를 선택하세요.
Avenger team Workspace Integrations panel showing Replit-managed integrations and the Connectors section, with the Add new connector button highlighted in the upper right
2

Plaid 커넥터 추가

Add new connector를 선택한 다음 Plaid를 선택하세요.
3

환경 선택

sandbox 또는 production을 선택하세요. 이는 사용하려는 Plaid Secret과 일치해야 합니다.
4

Plaid 자격 증명 입력

Plaid 대시보드의 Plaid Client IDSecret을 붙여넣으세요.
5

클라이언트 이름 설정

Plaid Link에 표시될 앱 이름을 입력하세요. 필드는 My Plaid App으로 미리 채워져 있으며, 사용자에게 표시할 이름으로 바꾸세요. Plaid가 올바르게 표시할 수 있도록 30자 이하로 유지하세요.
6

커넥터 저장

Configure를 선택해 커넥터를 저장하세요. Replit은 자격 증명을 안전하게 저장하고 빌더가 Plaid 계정을 연결할 때 이를 사용합니다.
Enable Plaid configuration dialog with fields for Environment, Client Id, Client Secret, and Client Name, plus a Configure button to save
나중에 구성을 변경하려면 Integrations 패널에서 Manage connectors를 열고 Plaid 옆의 Manage를 선택하세요.
Plaid connector Manage panel with the saved Environment, Client Id, Client Secret, and Client Name, and an Update button to save changes
조직 전체의 커넥터 관리에 대해서는 커넥터 관리하기를 참고하세요.

Plaid Link로 로그인하기

Plaid는 일반적인 OAuth 리디렉션 대신 Plaid Link를 사용합니다. 플로우를 시작하려면 Connectors 테이블에서 Plaid를 찾아 Sign in을 선택하세요. Replit은 연결을 확인하는 간단한 동의 화면을 표시한 후 Plaid Link를 엽니다.
Connect Plaid consent dialog with the Replit and Plaid logos, three reassurance bullets about connecting to Plaid, data use, and revocable permissions, and a Continue to Plaid button
그다음 Plaid Link는 각 사용자가 자신의 금융 기관을 선택하고 해당 기관으로 인증하는 임베드된 플로우를 엽니다.
Plaid Link institution picker titled Select your institution, with a search input and logos for major US banks including Chase, Bank of America, Wells Fargo, Citibank, US Bank, Capital One, PNC, USAA, American Express, TD, Regions, and Navy Federal, with a Sandbox mode banner at the bottom
각 사용자는 자신의 계정을 연결합니다. Replit은 해당 사용자의 연결에 대한 결과 Plaid 접근 토큰을 저장하고 Agent나 앱이 Plaid 데이터를 요청할 때 이를 사용합니다.

Plaid 데이터로 빌드 시작하기

Plaid가 연결되면, Agent에게 연결된 금융 데이터로 빌드해 달라고 요청하세요. 예를 들어: Plaid 데이터의 가용성은 연결된 기관과 Plaid 계정에 활성화된 Plaid 제품에 따라 달라집니다.

문제 해결

Plaid에는 유료 Replit 플랜이 필요합니다. 유료 플랜이지만 여전히 Plaid가 보이지 않으면 페이지를 새로고침하고 올바른 워크스페이스에 있는지 확인하세요.설정에서 This feature requires an enterprise plan이 표시되면, 페이지를 새로고침하고 올바른 워크스페이스를 사용하고 있는지 확인하세요.여전히 Plaid가 나타나지 않으면 Replit 지원팀에 문의해 팀에서 워크스페이스 구성을 확인할 수 있도록 하세요.
금융 기관이 계정 소유자에게 다시 로그인하도록 요구하거나, 자격 증명이 변경되거나, 권한이 취소된 경우 Plaid 연결이 끊길 수 있습니다.Integrations 또는 Connectors 패널에서 Plaid를 다시 연결하면 Plaid Link가 열리고 접근 권한이 복원됩니다.
Plaid 샌드박스와 프로덕션은 서로 다른 자격 증명과 토큰을 사용합니다. 커넥터 환경이 입력한 Plaid Secret 및 테스트 중인 금융 계정 유형과 일치하는지 확인하세요.

관련 문서