> ## 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. # API Verifikasi Identitas Google Wallet > Integrasikan verifikasi identitas Google Wallet ID ke aplikasi Anda dengan Didit. Lihat cakupan negara, langkah autentikasi, hasil, dan harga. Mulai verifikasi Google Wallet ID dari backend Anda menggunakan kunci API aplikasi Anda. Anda tidak memerlukan alur kerja atau `workflow_id`. Respons inisiasi menjelaskan tindakan autentikasi berikutnya; respons itu bukan hasil identitas yang disetujui. ## Cakupan dan aktivasi | Properti | Nilai | | - | - | | Dompet | Google Wallet ID | | ID dompet | `google_wallet` | | Negara | ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/us.svg)Amerika Serikat, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/gb.svg)Britania Raya, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/br.svg)Brasil, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/sg.svg)Singapura, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/tw.svg)Taiwan | | Aktivasi dompet produksi | ✅ Tersedia | | Harga dompet yang dipublikasikan | \$0.20 per verifikasi yang selesai | Aktivasi dompet terpisah dari penerapan API dan kelayakan aplikasi Anda. Endpoint yang terdokumentasi tidak mengaktifkan dompet yang ditandai Segera hadir. Untuk tarif yang saat ini dipublikasikan, lihat [harga dompet ID digital](https://docs.didit.me/id/getting-started/pricing.md#harga-dompet-id-digital). ## Yang dilakukan pengguna Halaman atau aplikasi Anda meminta langsung ke Google Wallet: tidak ada pengalihan dan tidak ada halaman yang di-hosting Didit. Teruskan `next_action.digital_credentials.request` ke `navigator.credentials.get({digital: request})` dalam interaksi pengguna pada `origin` yang Anda gunakan saat memulai, atau ke Android Credential Manager sebagai `GetDigitalCredentialOption`. Kemudian kirim respons yang dikembalikan dompet ke [Kirim respons dompet](https://docs.didit.me/id/standalone-apis/digital-id-wallet-response.md). Peramban menampilkan kode QR sendiri ketika dompet berada di perangkat lain. ## Menerima hasil Ikuti [panduan API dompet ID digital](https://docs.didit.me/id/standalone-apis/digital-id-wallets.md) untuk melacak verifikasi dan mengambil hasilnya. Anggap hanya hasil yang selesai dan terverifikasi sebagai bukti bahwa dompet mengautentikasi orang tersebut. Atribut identitas yang dikembalikan bergantung pada dompet; jangan berasumsi bahwa alamat, foto potret, atau setiap atribut yang diminta tersedia. ## Terkait * [API dompet ID digital](https://docs.didit.me/id/standalone-apis/digital-id-wallets.md) * [Cakupan dan atribut dompet](https://docs.didit.me/id/core-technology/id-verification/digital-id-wallets.md) * [Harga](https://docs.didit.me/id/getting-started/pricing.md#harga-dompet-id-digital) ## OpenAPI ````yaml id/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 Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/id-verification/wallets/google-wallet/: post: tags: - Digital ID wallets summary: Mulai verifikasi Google Wallet description: >- Mulai proses masuk Google Wallet (Google Wallet (ID pass) dan penerbit negara bagian AS (surat izin mengemudi seluler); USA, GBR, BRA, SGP, TWN) tanpa alur kerja apa pun. Ditagih sekali, hanya ketika identitas diverifikasi. Respons membawa next_action.type=request_digital_credential dengan permintaan yang ditandatangani Didit untuk aplikasi Anda, yang hanya dapat digunakan dari origin. Dalam gestur pengguna di sana, teruskan next_action.digital_credentials.request ke navigator.credentials.get({digital: ...}) (atau ke Android Credential Manager sebagai GetDigitalCredentialOption requestJson), lalu lakukan POST terhadap data yang dikembalikan dompet ke /v3/id-verification/wallets/verifications/{request_id}/response/. Browser menyediakan kode QR-nya sendiri saat dompet berada di perangkat lain. Aplikasi sandbox mendapatkan simulasi deterministik (simulated: true) yang tidak pernah menghubungi penyedia. operationId: start_google_wallet_wallet_verification parameters: - in: header name: Idempotency-Key schema: type: string description: >- Kunci keamanan coba lagi opsional (maks 255 karakter). Mencoba lagi dengan kunci, dompet, dan body yang sama akan mengembalikan verifikasi asli tanpa memulai proses masuk kedua; kunci yang sama dengan dompet atau body lain akan mengembalikan 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: >- Error validasi kolom ({field: [messages]}), atau error return_url_invalid, return_url_not_allowed, origin_invalid, origin_not_allowed, invalid_personal_code, invalid_phone_number, atau idempotency_key_invalid. '403': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartForbidden description: >- Kredensial tidak ada ({detail}), atau kesalahan wallet_unavailable, insufficient_credits, atau contract_rate_missing. '409': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- kesalahan idempotency_key_reused atau idempotency_key_in_progress (dengan Retry-After). '502': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- kesalahan wallet_provider_unavailable: penyedia tidak dapat memulai; tidak ada yang dibuat. '503': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- kesalahan wallet_not_configured: lingkungan ini tidak dapat menjangkau dompet. 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: Mulai verifikasi Google Wallet (USA, GBR, BRA, SGP, TWN). properties: vendor_data: type: string nullable: true description: >- Referensi Anda sendiri untuk verifikasi ini (mis. ID pengguna Anda). Dikembalikan dalam hasil dan webhook. metadata: type: object additionalProperties: {} nullable: true description: >- Objek JSON opsional yang disimpan bersama verifikasi dan dikembalikan dalam hasil serta webhook. sandbox_scenario: type: string minLength: 1 description: >- Khusus aplikasi sandbox: hasil simulasi - 'wallet_cancelled', 'wallet_timeout', atau 'wallet_provider_error'; skenario lain (atau tanpa skenario) akan lolos verifikasi. Ditolak pada aplikasi di lingkungan produksi. Katalog lengkap tersedia di GET /v1/sandbox/scenarios/. country: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartCountryEnum description: |- Negara ISO 3166-1 alpha-3 dari identitas Google Wallet. * `USA` - USA * `GBR` - GBR * `BRA` - BRA * `SGP` - SGP * `TWN` - TWN origin: type: string minLength: 1 description: >- Lokasi halaman atau aplikasi Anda akan meminta dompet: origin https dari halaman Anda (host-nya harus berada di allowed_return_hosts aplikasi, atau domain White Label miliknya), mis. https://app.example.com, atau android:apk-key-hash:. Dompet menolak permintaan di tempat lain mana pun. maxLength: 256 required: - country - origin DigitalIdWalletApiWalletVerificationResponse: type: object description: >- Satu verifikasi dompet mandiri, sebagaimana setiap endpoint dompet meresponsnya. 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: Objek metadata yang dikirim saat mulai, atau 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: Kode stabil yang dapat dibaca mesin, mis. 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: >- Belum Selesai saat tertunda, kemudian Disetujui (diverifikasi) atau Ditolak. 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 setelah tanda tangan kredensial diverifikasi; null untuk kredensial simulasi. 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: >- Kesalahan validasi permintaan: setiap kolom yang ditolak beserta pesannya. 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: ID katalog dompet, misalnya 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` - Menunggu * `verified` - Terverifikasi * `cancelled` - Dibatalkan oleh pengguna * `timeout` - Waktu habis * `failed` - Gagal 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: arahkan peramban pengguna ke url. confirm_in_app: tampilkan verification_code kepada pengguna, yang memeriksa kecocokannya dengan kode di aplikasi dompet mereka dan mengonfirmasinya di sana; lalu lakukan polling. request_digital_credential: dalam interaksi pengguna pada origin tempat Anda memulai, minta ke dompet dengan digital_credentials.request, lalu kirimkan hasilnya ke 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: 'khusus redirect: tempat pengguna masuk dengan dompet.' digital_credentials: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialsRequest description: >- khusus request_digital_credential: permintaan yang diserahkan ke dompet. verification_code: type: string description: >- hanya confirm_in_app: kode perbandingan 4 digit yang juga ditampilkan oleh aplikasi dompet. poll_interval_seconds: type: integer description: >- hanya confirm_in_app: seberapa sering memanggil POST .../verifications/{request_id}/poll/ untuk umpan balik cepat. Didit juga melakukan polling proses masuk yang tertunda di latar belakang, sehingga webhook melaporkan hasilnya meskipun Anda tidak melakukan polling. 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: >- Kewarganegaraan ISO3, hanya jika dompet menyatakannya (tidak pernah disimpulkan). issuing_state: type: string description: Negara ISO3 yang skemanya menerbitkan identitas. 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: >- Teruskan apa adanya: navigator.credentials.get({digital: request}) di browser, atau JSON.stringify(request) sebagai requestJson milik GetDigitalCredentialOption di Android. Ditandatangani oleh Didit untuk aplikasi Anda. required: - protocol - request securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: Token akses client-credentials milik aplikasi. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.