메인 콘텐츠로 건너뛰기
POST
cURL
Google Wallet ID 신분증 인증은 애플리케이션 API 키를 사용해 백엔드에서 시작하세요. 워크플로나 workflow_id는 필요하지 않습니다. 시작 응답은 다음 인증 작업을 설명하는 것이며, 승인된 신원 확인 결과가 아닙니다.

적용 범위 및 활성화

지갑 활성화는 API 배포 및 애플리케이션의 자격 요건과는 별개입니다. 문서화된 endpoint라도 출시 예정으로 표시된 지갑을 활성화하지는 않습니다. 현재 공개된 요금은 디지털 ID 지갑 요금을 참고하세요.

사용자가 하는 일

페이지나 앱이 Google Wallet 자체에 요청합니다. 리디렉션이나 Didit가 호스팅하는 페이지는 없습니다. next_action.digital_credentials.request를 시작할 때 사용한 origin에서 사용자 제스처로 navigator.credentials.get({digital: request})에 전달하거나, Android Credential Manager에 GetDigitalCredentialOption으로 전달하세요. 그런 다음 지갑이 반환한 내용을 지갑 응답 제출로 보내세요. 지갑이 다른 기기에 있으면 브라우저가 자체 QR 코드를 표시합니다.

결과 받기

디지털 ID 지갑 API 가이드를 따라 인증을 추적하고 결과를 가져오세요. 완료되고 검증된 결과만 지갑이 사용자를 인증했다는 증거로 간주하세요. 반환되는 신원 속성은 지갑마다 다르므로, 주소나 사진 또는 요청한 모든 속성이 포함되어 있다고 가정하지 마세요.

관련 문서

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

헤더

Idempotency-Key
string

선택적 재시도 안전 키(최대 255자)입니다. 동일한 키, 지갑 및 본문으로 재시도하면 두 번째 로그인을 시작하지 않고 기존 인증을 반환합니다. 동일한 키를 다른 지갑이나 본문과 함께 사용하면 409 idempotency_key_reused를 반환합니다.

본문

Google Wallet 인증(USA, GBR, BRA, SGP, TWN)을 시작합니다.

country
enum<string>
필수

Google Wallet 신원의 ISO 3166-1 alpha-3 국가입니다.

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
사용 가능한 옵션:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
필수

페이지 또는 앱이 지갑에 요청을 보낼 위치: 페이지의 https origin(해당 호스트는 애플리케이션의 allowed_return_hosts에 포함되어 있거나 화이트 라벨 도메인이어야 함, 예: https://app.example.com) 또는 android:apk-key-hash:<패딩 없는 앱 서명 인증서의 base64 SHA-256>. 지갑은 그 외의 모든 위치에서 요청을 거부합니다.

Required string length: 1 - 256
vendor_data
string | null

이 인증에 대한 귀하 고유의 참조값(예: 사용자 ID)입니다. 결과 및 webhook으로 반환됩니다.

metadata
object | null

인증 건과 함께 저장되고 결과 및 webhook에 반환되는 선택적 JSON 객체입니다.

sandbox_scenario
string

샌드박스 애플리케이션 전용: 시뮬레이션된 결과 - 'wallet_cancelled', 'wallet_timeout' 또는 'wallet_provider_error'. 다른 시나리오(또는 시나리오를 지정하지 않은 경우)는 검증에 성공합니다. 프로덕션 애플리케이션에서는 거부됩니다. 전체 카탈로그는 GET /v1/sandbox/scenarios/에서 확인할 수 있습니다.

Minimum string length: 1

응답

모든 지갑 endpoint가 응답하는 단일 독립형 지갑 검증입니다.

request_id
string<uuid>
필수
wallet_verification
object
필수
vendor_data
string | null
필수
metadata
object | null
필수

시작 시 전송된 메타데이터 객체 또는 null입니다.

created_at
string<date-time>
필수
마지막 수정일 2026년 11월 7일