Langsung ke konten utama
POST
cURL
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

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.

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. Peramban menampilkan kode QR sendiri ketika dompet berada di perangkat lain.

Menerima hasil

Ikuti panduan API dompet ID digital 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

Otorisasi

x-api-key
string
header
wajib

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.

Header

Idempotency-Key
string

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.

Body

Mulai verifikasi Google Wallet (USA, GBR, BRA, SGP, TWN).

country
enum<string>
wajib

Negara ISO 3166-1 alpha-3 dari identitas Google Wallet.

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
Opsi yang tersedia:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
wajib

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:<base64 SHA-256 dari sertifikat penandatanganan aplikasi Anda, tanpa padding>. Dompet menolak permintaan di tempat lain mana pun.

Required string length: 1 - 256
vendor_data
string | null

Referensi Anda sendiri untuk verifikasi ini (mis. ID pengguna Anda). Dikembalikan dalam hasil dan webhook.

metadata
object | null

Objek JSON opsional yang disimpan bersama verifikasi dan dikembalikan dalam hasil serta webhook.

sandbox_scenario
string

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/.

Minimum string length: 1

Respons

Satu verifikasi dompet mandiri, sebagaimana setiap endpoint dompet meresponsnya.

request_id
string<uuid>
wajib
wallet_verification
object
wajib
vendor_data
string | null
wajib
metadata
object | null
wajib

Objek metadata yang dikirim saat mulai, atau null.

created_at
string<date-time>
wajib
Terakhir diubah pada 7 November 2026