빠른 시작

로컬 실행링크 복사

저장소 접근 권한과 Node.js를 준비한 뒤 took-wss 루트에서 실행합니다.

npm install
npm run dev

참조 호스트에서 세션·bootstrap·브리지 연결을 확인합니다. 실제 자산 기능에는 별도의 공급자 설정이 필요합니다.

기관 서버에서 세션 발급링크 복사

고객 인증 후 기관 서버에서 호출합니다. 기관 키는 앱 코드에 넣지 않습니다.

curl "$WSS_BFF_URL/v1/sessions" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "x-wss-institution-key: $WSS_INSTITUTION_KEY" \
  -d '{"tenantId":"YOUR_TENANT_ID","customerRef":"customer-123"}'

환경변수와 YOUR_TENANT_ID를 실제 환경 값으로 바꿉니다. 요청·응답 상세

앱에서 지갑 연결링크 복사

1. 기관 서버의 자체 인증 API로 sessionToken, expiresAt, walletUrl을 앱에 전달합니다. 이 API 경로는 기관이 정합니다.
2. SDK 초기화 예제에 세션을 넣습니다. client.start() 후 iframe 주소를 설정합니다.
3. took-wss:bootstrapped로 연결 완료를 확인합니다. ready는 초기화 메시지 수신 준비 상태이며, 오류는 took-wss:error로 받습니다.
4. 화면 종료 시 client.stop()을 호출합니다. 고객·세션 변경이나 iframe 재로드에는 새 인스턴스를 만듭니다.

현재 SDK 예제는 브라우저 iframe 기준입니다. iOS·Android 네이티브 SDK는 미확정입니다.