> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Верификация личности Google Wallet: API > Интегрируйте верификацию личности через Google Wallet ID в приложение с Didit. Покрытие стран, шаги аутентификации, результаты и цены. Запускайте верификацию Google Wallet ID с вашего бэкенда, используя API-ключ приложения. Сценарий и `workflow_id` не нужны. Ответ на запрос запуска описывает следующее действие аутентификации; это не одобренный результат верификации личности. ## Покрытие и активация | Параметр | Значение | | - | - | | Кошелёк | Google Wallet ID | | Wallet ID | `google_wallet` | | Страны | ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/us.svg)США, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/gb.svg)Великобритания, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/br.svg)Бразилия, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/sg.svg)Сингапур, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/tw.svg)Тайвань | | Активация кошелька в продакшне | ✅ Доступно | | Опубликованная цена кошелька | \$0.20 за завершённую верификацию | Активация кошелька отделена от развёртывания API и от соответствия вашего приложения требованиям. Документированный endpoint не активирует кошелёк, отмеченный как «Скоро». Актуальные опубликованные тарифы см. в разделе [Цены на цифровые ID-кошельки](https://docs.didit.me/ru/getting-started/pricing.md#цены-на-цифровые-кошельки-удостоверений-личности). ## Что делает пользователь Ваша страница или приложение обращается непосредственно к Google Wallet: перенаправления и страницы, размещённой на Didit, нет. Передайте `next_action.digital_credentials.request` в `navigator.credentials.get({digital: request})` в ответ на действие пользователя на `origin`, с которого вы запустили верификацию, или в Android Credential Manager как `GetDigitalCredentialOption`. Затем отправьте полученный от кошелька ответ в [Отправка ответа кошелька](https://docs.didit.me/ru/standalone-apis/digital-id-wallet-response.md). Если кошелёк находится на другом устройстве, браузер сам показывает QR-код. ## Получение результата Следуйте [руководству по API цифровых ID-кошельков](https://docs.didit.me/ru/standalone-apis/digital-id-wallets.md), чтобы отслеживать верификацию и получить её результат. Считайте доказательством того, что кошелёк аутентифицировал пользователя, только завершённый и подтверждённый результат. Набор возвращаемых атрибутов личности зависит от кошелька: не рассчитывайте, что будут переданы адрес, портрет или все запрошенные атрибуты. ## Связанные материалы * [API цифровых ID-кошельков](https://docs.didit.me/ru/standalone-apis/digital-id-wallets.md) * [Покрытие кошельков и атрибуты](https://docs.didit.me/ru/core-technology/id-verification/digital-id-wallets.md) * [Цены](https://docs.didit.me/ru/getting-started/pricing.md#цены-на-цифровые-кошельки-удостоверений-личности) ## OpenAPI ````yaml ru/openapi-25.json POST /v3/id-verification/wallets/google-wallet/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/id-verification/wallets/google-wallet/: post: tags: - Digital ID wallets summary: Запустить верификацию через Google Wallet description: >- Запустить вход через Google Wallet (Google Wallet (ID pass) и эмитенты штатов США (мобильные водительские удостоверения); USA, GBR, BRA, SGP, TWN) без какого-либо сценария. Тарифицируется один раз, только после успешной верификации личности. Ответ содержит next_action.type=request_digital_credential с запросом, подписанным Didit для вашего приложения, доступным для использования только с origin. При пользовательском действии на этой странице передайте next_action.digital_credentials.request в navigator.credentials.get({digital: ...}) (или в Android Credential Manager как GetDigitalCredentialOption requestJson), затем отправьте результат от кошелька через POST на /v3/id-verification/wallets/verifications/{request_id}/response/. Браузер предложит собственный QR-код, если кошелёк находится на другом устройстве. Приложения в песочнице получают детерминированную симуляцию (simulated: true), которая никогда не обращается к провайдеру. operationId: start_google_wallet_wallet_verification parameters: - in: header name: Idempotency-Key schema: type: string description: >- Необязательный ключ для безопасного повтора запроса (макс. 255 символов). Повторная попытка с тем же ключом, кошельком и телом запроса возвращает исходную верификацию без запуска повторного входа; тот же ключ с другим кошельком или телом запроса возвращает 409 idempotency_key_reused. requestBody: content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartRequest example: country: USA vendor_data: your-customer-reference metadata: reference: example origin: https://app.example.com application/x-www-form-urlencoded: schema: $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartRequest multipart/form-data: schema: $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartRequest required: true responses: '201': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResponse example: request_id: 00000000-0000-4000-8000-000000000001 wallet_verification: wallet: id: google_wallet name: Google Wallet issuing_authority: >- Google Wallet (ID pass) and US state issuers (mobile driving licence) country: USA status: Not Finished outcome: pending error: null interaction: digital_credentials simulated: false expires_at: '2026-01-01T10:10:00Z' next_action: type: request_digital_credential digital_credentials: protocol: openid4vp-v1-signed request: requests: - protocol: openid4vp-v1-signed data: request: identity: null attributes: null level_of_assurance: null verified_at: null signature_valid: null credential_type: person_identification vendor_data: your-customer-reference metadata: reference: example created_at: '2026-01-01T10:00:00Z' description: '' '400': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartBadRequest description: >- Ошибки валидации полей ({field: [messages]}) или ошибка return_url_invalid, return_url_not_allowed, origin_invalid, origin_not_allowed, invalid_personal_code, invalid_phone_number либо idempotency_key_invalid. '403': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartForbidden description: >- Отсутствуют учетные данные ({detail}), либо возникла ошибка wallet_unavailable, insufficient_credits или contract_rate_missing. '409': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- ошибка idempotency_key_reused или idempotency_key_in_progress (с заголовком Retry-After). '502': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- ошибка wallet_provider_unavailable: не удалось запустить провайдера; ничего не было создано. '503': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- ошибка wallet_not_configured: эта среда не может связаться с кошельком. security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request POST \ --url https://verification.didit.me/v3/id-verification/wallets/google-wallet/ \ --header 'x-api-key: YOUR_API_KEY' \ --header 'Idempotency-Key: your-unique-attempt-key' \ --header 'Content-Type: application/json' \ --data '{ "country": "USA", "vendor_data": "your-customer-reference", "metadata": { "reference": "example" }, "origin": "https://app.example.com" }' components: schemas: DigitalIdWalletApiGoogleWalletWalletVerificationStartRequest: type: object description: Запустить верификацию через Google Wallet (USA, GBR, BRA, SGP, TWN). properties: vendor_data: type: string nullable: true description: >- Ваш собственный референс этой верификации (например, идентификатор пользователя). Возвращается в результатах и webhook. metadata: type: object additionalProperties: {} nullable: true description: >- Необязательный объект JSON, сохраняемый вместе с верификацией и возвращаемый в результатах и webhook. sandbox_scenario: type: string minLength: 1 description: >- Только для приложений в песочнице: имитируемый результат - 'wallet_cancelled', 'wallet_timeout' или 'wallet_provider_error'; любой другой сценарий (или его отсутствие) проходит верификацию. Отклоняется для приложений в продакшн-среде. Полный каталог доступен по адресу GET /v1/sandbox/scenarios/. country: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartCountryEnum description: |- Код страны ISO 3166-1 alpha-3 для удостоверения Google Wallet. * `USA` - USA * `GBR` - GBR * `BRA` - BRA * `SGP` - SGP * `TWN` - TWN origin: type: string minLength: 1 description: >- Откуда ваша страница или приложение будут запрашивать кошелёк: https origin вашей страницы (её хост должен входить в allowed_return_hosts приложения или являться его доменом White label), например https://app.example.com, либо android:apk-key-hash:. В любом другом месте кошелёк отклонит запрос. maxLength: 256 required: - country - origin DigitalIdWalletApiWalletVerificationResponse: type: object description: >- Одна отдельная верификация кошелька в том виде, в котором её возвращает каждый endpoint для кошельков. properties: request_id: type: string format: uuid wallet_verification: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationResult' vendor_data: type: string nullable: true metadata: type: object additionalProperties: {} nullable: true description: Объект метаданных, переданный при запуске, или null. created_at: type: string format: date-time required: - created_at - metadata - request_id - vendor_data - wallet_verification DigitalIdWalletApiWalletVerificationStartBadRequest: oneOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationFieldErrors' DigitalIdWalletApiWalletVerificationStartForbidden: oneOf: - $ref: >- #/components/schemas/DigitalIdWalletApiClientCredentialsForbiddenErrorMessage - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' DigitalIdWalletApiWalletVerificationError: type: object properties: error: type: string description: Постоянный машиночитаемый код, например wallet_unavailable. detail: type: string required: - detail - error DigitalIdWalletApiGoogleWalletWalletVerificationStartCountryEnum: enum: - USA - GBR - BRA - SGP - TWN type: string description: |- * `USA` - USA * `GBR` - GBR * `BRA` - BRA * `SGP` - SGP * `TWN` - TWN DigitalIdWalletApiWalletVerificationResult: type: object properties: wallet: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWallet' readOnly: true country: type: string status: type: string description: >- Не завершена (Not Finished), пока находится в ожидании, затем Одобрена (Approved / верифицирована) или Отклонена (Declined). outcome: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResultOutcomeEnum error: type: string nullable: true readOnly: true interaction: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiInteractionEnum' readOnly: true simulated: type: boolean readOnly: true expires_at: type: string format: date-time next_action: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextAction' nullable: true readOnly: true identity: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletIdentity' nullable: true readOnly: true attributes: type: object additionalProperties: {} nullable: true readOnly: true level_of_assurance: type: string nullable: true verified_at: type: string format: date-time nullable: true signature_valid: type: boolean nullable: true description: >- True, если подпись учётных данных была подтверждена; null для имитированных учётных данных. credential_type: type: string nullable: true required: - attributes - country - credential_type - error - expires_at - identity - interaction - level_of_assurance - next_action - outcome - signature_valid - simulated - status - verified_at - wallet DigitalIdWalletApiWalletVerificationFieldErrors: type: object description: >- Ошибки валидации запроса: каждое отклонённое поле с соответствующими сообщениями. additionalProperties: type: array items: type: string DigitalIdWalletApiClientCredentialsForbiddenErrorMessage: type: object properties: detail: type: string default: Forbidden - User doesn't have permission DigitalIdWalletApiWallet: type: object properties: id: type: string description: Каталожный идентификатор кошелька, например bankid_se. name: type: string issuing_authority: type: string nullable: true required: - id - issuing_authority - name DigitalIdWalletApiWalletVerificationResultOutcomeEnum: enum: - pending - verified - cancelled - timeout - failed type: string description: |- * `pending` - В ожидании * `verified` - Подтверждено * `cancelled` - Отменено пользователем * `timeout` - Время ожидания истекло * `failed` - Не удалось DigitalIdWalletApiInteractionEnum: enum: - redirect - in_app - digital_credentials type: string description: |- * `redirect` - redirect * `in_app` - in_app * `digital_credentials` - digital_credentials DigitalIdWalletApiWalletNextAction: type: object properties: type: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextActionTypeEnum' description: >- redirect: перенаправьте браузер пользователя на url. confirm_in_app: покажите verification_code пользователю, который сверяет его с кодом в приложении своего кошелька и подтверждает там; затем выполняйте опрос. request_digital_credential: при взаимодействии пользователя в исходном источнике запросите кошелёк с помощью digital_credentials.request, затем отправьте возвращённый результат в POST .../verifications/{request_id}/response/. * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential url: type: string format: uri description: >- Только для redirect: адрес, по которому пользователь входит в систему с помощью кошелька. digital_credentials: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialsRequest description: >- Только для request_digital_credential: запрос для передачи в кошелёк. verification_code: type: string description: >- Только для confirm_in_app: 4-значный код сравнения, который также отображается в приложении кошелька. poll_interval_seconds: type: integer description: >- Только для confirm_in_app: как часто вызывать POST .../verifications/{request_id}/poll/ для быстрого получения статуса. Didit также выполняет фоновые опросы незавершённых входов, поэтому webhook сообщит о результате, даже если вы не выполняете опросы. required: - type DigitalIdWalletApiWalletIdentity: type: object properties: full_name: type: string nullable: true first_name: type: string nullable: true last_name: type: string nullable: true date_of_birth: type: string format: date nullable: true nationality: type: string nullable: true description: >- Гражданство по ISO3, только если оно прямо заявлено кошельком (никогда не определяется косвенно). issuing_state: type: string description: Страна по ISO3, схема которой выдала удостоверение. required: - date_of_birth - first_name - full_name - issuing_state - last_name - nationality DigitalIdWalletApiWalletNextActionTypeEnum: enum: - redirect - confirm_in_app - request_digital_credential type: string description: |- * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential DigitalIdWalletApiWalletDigitalCredentialsRequest: type: object properties: protocol: type: string description: openid4vp-v1-signed. request: type: object additionalProperties: {} description: >- Передайте как есть: navigator.credentials.get({digital: request}) в браузере или JSON.stringify(request) как requestJson для GetDigitalCredentialOption на Android. Подписано Didit для вашего приложения. required: - protocol - request securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: Токен доступа приложения, полученный по учётным данным клиента. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.