Перейти к основному содержанию
POST
cURL
Запускайте верификацию Google Wallet ID с вашего бэкенда, используя API-ключ приложения. Сценарий и workflow_id не нужны. Ответ на запрос запуска описывает следующее действие аутентификации; это не одобренный результат верификации личности.

Покрытие и активация

Активация кошелька отделена от развёртывания API и от соответствия вашего приложения требованиям. Документированный endpoint не активирует кошелёк, отмеченный как «Скоро». Актуальные опубликованные тарифы см. в разделе Цены на цифровые ID-кошельки.

Что делает пользователь

Ваша страница или приложение обращается непосредственно к Google Wallet: перенаправления и страницы, размещённой на Didit, нет. Передайте next_action.digital_credentials.request в navigator.credentials.get({digital: request}) в ответ на действие пользователя на origin, с которого вы запустили верификацию, или в Android Credential Manager как GetDigitalCredentialOption. Затем отправьте полученный от кошелька ответ в Отправка ответа кошелька. Если кошелёк находится на другом устройстве, браузер сам показывает QR-код.

Получение результата

Следуйте руководству по API цифровых ID-кошельков, чтобы отслеживать верификацию и получить её результат. Считайте доказательством того, что кошелёк аутентифицировал пользователя, только завершённый и подтверждённый результат. Набор возвращаемых атрибутов личности зависит от кошелька: не рассчитывайте, что будут переданы адрес, портрет или все запрошенные атрибуты.

Связанные материалы

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как 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>
обязательно

Код страны ISO 3166-1 alpha-3 для удостоверения Google Wallet.

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
Доступные опции:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
обязательно

Откуда ваша страница или приложение будут запрашивать кошелёк: https origin вашей страницы (её хост должен входить в allowed_return_hosts приложения или являться его доменом White label), например https://app.example.com, либо android:apk-key-hash:<base64 SHA-256 сертификата подписи вашего приложения, без паддинга>. В любом другом месте кошелёк отклонит запрос.

Required string length: 1 - 256
vendor_data
string | null

Ваш собственный референс этой верификации (например, идентификатор пользователя). Возвращается в результатах и webhook.

metadata
object | null

Необязательный объект JSON, сохраняемый вместе с верификацией и возвращаемый в результатах и webhook.

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>
обязательно
Последнее изменение 7 ноября 2026 г.