Didit API·SDK·webhook 연동 방법

전체 스크립트: Didit 앱에 연동하기: API, SDK, webhook (개발자 가이드) - Didit Academy 영상 8/10, 08:13. YouTube에서 보기. 각 단락은 영상의 정확한 순간으로 연결됩니다.

​

구현할 내용

00:04 이 영상에서는 여러분의 앱에 Didit을 연동하는 방법을 알아봅니다. 사용자는 제품 안에서 바로 인증을 완료하고, 모든 결과는 발생하는 즉시 여러분의 시스템으로 전달됩니다. 개발자를 위한 영상이라 조금 더 기술적이지만, 생각보다 간단합니다. 끝까지 보시면 대부분의 작업을 클라우드 코드에 맡겨 앱을 만들게 할 수도 있다는 것을 알게 되실 겁니다. 그래서 실제로 구현하는 순서대로 살펴보겠습니다.

​

SDK, API, webhook: 세 가지 구성 요소

00:28 실제로 어떻게 구축하는지 순서대로 보겠습니다. 바로 시작하죠. Didit을 연동하려면 세 가지를 설정해야 합니다. SDK는 여러분의 앱 안에서 카메라, 문서 촬영, NFC 읽기, 라이브니스 UI를 렌더링합니다. API는 서버 간 통신이며, 백엔드가 세션을 생성하고 최종 결정 결과를 읽습니다. webhook은 세션 상태가 바뀌는 순간 여러분의 HTTPS endpoint를 호출하며, 이는 결과를 폴링하는 방식보다 훨씬 빠르고 풍부합니다.

​

Integrate 탭

00:56 가장 쉬운 연동 방법은 Manage 탭으로 가서 Integrate를 클릭하는 것입니다. 여기서 모든 설정을 가져올 수 있습니다. API 키를 복사할 수 있고, 지금 작업 중인 이 앱만을 위한 전용 API 키를 설정할 수도 있습니다. 연동할 워크플로를 만들고 선택할 수 있습니다. webhook도 추가할 수 있는데, 이는 인증 결과가 전달되는 곳입니다. 01:24 그리고 잠시 후 보여드릴 서명 비밀키는 여러분의 ENV 파일에 들어가야 하는 값입니다.

​

플랫폼 선택

01:28 그다음 앱에 연결하면 됩니다. 여기에는 여러 옵션이 있습니다. Web JS, React Native, iOS, Android, Flutter 등 여러 플랫폼이 있으니 앱에 맞는 것을 선택하면 됩니다. 이는 여러분의 서버에 있는 ENV 파일에 넣을 환경 시크릿입니다.

​

AI 설정 프롬프트

01:48 가장 쉬운 방법은 AI 설정 프롬프트를 사용하는 것입니다. 여기서 모든 설정을 구성한 다음 프롬프트를 복사하면, 방금 완료한 설정에서 필요한 정보가 모두 복사됩니다. 이를 붙여넣어 Cloud Code나 Codex, 또는 앱을 만들고 있는 곳 어디에든 넣으면 됩니다.

​

환경별 API 키

02:09 API 키는 여기에 있으며, 각 행마다 키가 하나씩 있습니다. 좋은 습관은 환경별, 연동별로 키를 따로 두는 것입니다. 그래야 하나를 교체하거나 폐기해도 다른 키에는 영향이 없습니다. 특정 워크플로를 연동하려는 경우에는, 예를 들어 그 워크플로만을 위한 별도 API 키를 두는 것이 좋습니다.

​

키 생성하기

02:27 이제 Create API key를 클릭하겠습니다. 여기서는 test라고 입력하고 키를 생성하겠습니다. 이제 복사할 수 있는데, 다시는 볼 수 없습니다. 그래서 반드시 복사해서 어딘가에 메모해 두었다가 연동 작업을 할 때 사용해야 합니다. 연동 섹션으로 가서 API 키를 가져오면, 예를 들어 test 키를 선택하고 아래로 내려가 KYC 워크플로를 선택하겠습니다. webhook을 추가할 수 있습니다. 03:05 앱을 연결합니다. 그리고 여기 있는 설정 프롬프트를 붙여넣을 수 있습니다. 보시다시피 이 프롬프트에는

​

webhook 개요

03:13 API 키가 포함됩니다. 이제 webhook으로 넘어가 보겠습니다. 원하는 거의 모든 것에 대해 webhook을 설정할 수 있습니다. 예를 들어 특정 이벤트를 Slack으로 보내고 싶다면

​

문서

03:25 webhook URL을 여기에 추가하면 됩니다. 자, 이제 문서를 살펴보겠습니다. 모든 기술 문서에 접근할 수 있습니다. docs.didit.me로 가서 몇 가지를 보겠습니다.

​

세션 생성: 유일한 필수 필드

03:37 여기서는 모든 것이 세션 생성을 중심으로 돌아갑니다. 이는 POST 요청이며 인증의 시작입니다. curl 요청을 보면 워크플로 ID가 있습니다. 이것이 유일한 필수 필드이고, 특히 유용한 점은 같은 endpoint로 KYC 세션과 KYB 세션을 모두 생성할 수 있다는 것입니다. 워크플로가 KYC 세션인지 KYB 세션인지 결정합니다.

​

벤더 데이터와 콜백 URL

04:00 아래에는 추가 필드가 몇 개 더 있는데, 여기에는 이 영상들에서 여러 번 언급한 벤더 데이터가 포함됩니다. 이는 각 사용자의 고유 식별자로, 원하는 대로 정의할 수 있습니다. 이메일이든 고유 식별자든 상관없습니다. 그리고 여기 콜백 URL이 있습니다. 이는 사용자가 인증 워크플로를 완료한 후 이동하는 곳입니다.

​

endpoint 직접 테스트하기

04:24 아래로 스크롤하면 직접 시험해 볼 수 있습니다. Try it을 클릭하면 여기서 인증 세션을 실제로 생성할 수 있습니다. 여기에 API 키 하나를 넣겠습니다. 새로 만든 test2 키를 복사해서 붙여넣겠습니다. 워크플로 ID가 필요하니 저쪽으로 가서 이 워크플로 ID를 가져옵니다. 그것을 여기에 입력합니다. 벤더 데이터는 필수가 아닙니다. 임의의 숫자 문자열을 넣겠습니다. 05:02 콜백은 여기서 그대로 두겠습니다. 참고로 이 중 어느 것도 필수가 아닙니다. 제가 테스트 계정을 사용하고 있어서 그런 것 같지만, 이 endpoint를 테스트하려면 이렇게 하면 됩니다. 개발자이고 구체적인 답이 필요하다면 문서를 확인하면 됩니다. MCP도 이 모든 문서에 접근할 수 있으므로, MCP를 연동하고 Claude에게 기술적인 질문을 직접 하면 대부분 이 문서에서 답을 찾을 수 있습니다.

​

Webhook: 폴링을 사용하지 않는 이유

05:32 이 안에서 말씀드리겠습니다. 이제 webhook에 대해 이야기해 보겠습니다. 관리 섹션에 webhook 탭이 있으며, 결과가 실제로 전달되는 경로가 바로 이것입니다. 폴링은 속도가 느리기 때문에 webhook을 권장합니다. 그리고

​

대상 추가 및 이벤트 선택

05:44 더 많은 요청이 필요하고 이벤트를 건너뛰게 됩니다. 여기서 새 webhook 대상을 추가합니다. URL을 붙여 넣을 수 있고, 받고 싶은 이벤트를 선택할 수 있습니다. 즉, 이 특정 endpoint로 보내고 싶은 데이터가 모두 여기에 포함됩니다. 그러면 Didit이 한 번만 제공되는 서명 비밀을 돌려주는데, 이는 잠시 후에 보여 드리겠습니다. 그리고 URL에 직접 연결할 수 있어야 합니다. 따라서 localhost와 프라이빗 IP는 사용할 수 없습니다. 이 화면에서 나간 다음 오른쪽으로 스크롤하면 몇 가지 옵션이 보입니다. 06:16 여기서 이 webhook이 수신하는 이벤트 수를 확인할 수 있고

​

서명 비밀

06:19 서명 비밀을 복사할 수 있는데, 이는 연동에 중요합니다. 연동 탭에서 연동을 설정할 때 말씀드렸던 것처럼 프롬프트가 있습니다. 그리고 그 설정에서 선택한 webhook에 대한 서명 비밀이 여기에 표시됩니다. 그래서

​

Webhook 핸들러 프롬프트

06:34 AI를 활용하는 또 다른 방법으로, webhook 탭에서 찾은 미리 만들어진 프롬프트가 있습니다. AI로 webhook 핸들러를 설정하고 싶다면 이것을 사용할 수 있습니다. 문서를 살펴보면 연동 프롬프트를 찾을 수 있습니다. 이 프롬프트는 신원 확인, 엔티티, 거래를 다룹니다. 필요한 모든 것을 만들어 줍니다. 무엇을 구축해야 하는지, 검증용 서명 헤더, 방금 webhook을 설정할 때 보셨던 webhook 이벤트 유형, webhook 엔벨로프 등 많은 내용을 전부 정리해 줍니다. 또한 어느 도구의 어디에 붙여 넣을지도 선택할 수 있습니다. 07:15 이 프롬프트를 사용하고 싶다면 이것이 가장 쉽게 시작하고 연동을 설정하는 방법입니다. 이 영상에서 방금 설명한 모든 내용은 MCP 서버를 연동하면 AI 도구 안에서 접근하고 조회할 수 있습니다. 따라서 원하는 것을 자연어로 설명하기만 하면 Cloud Code가 문서를 읽고 연동을 만들어 줍니다. 여러분은 작업을 확인하고 정상적으로 실행되고 작동하는지 점검하기만 하면 됩니다. 모든 코드를 처음부터 직접 작성할 필요가 없습니다.

​

요약

07:41 이것이 앱 안에서의 Didit입니다. 사용자가 보는 SDK, 백엔드가 호출하는 API, 그리고 여러분이 구축하는 기반이 되는 판정 결과를 전달하는 서명된 webhook입니다. webhook을 신뢰하고, 어디서나 벤더 데이터를 사용하며, 설정 프롬프트를 활용하세요. 그러면 반복적인 부분을 일일이 직접 연결하지 않아도 됩니다. didit.me로 이동해 무료로 가입하면 몇 분 안에 인증을 실행해 볼 수 있습니다.