跳转到主要内容
POST
cURL
请从您的后端使用应用 API 密钥发起 Google Wallet ID 验证。 您无需工作流或 workflow_id。 发起响应描述的是下一步认证操作,并不表示身份已通过验证。

覆盖范围与激活

钱包激活与 API 部署及您的应用资格相互独立。 即使文档中列出了某个 endpoint,标记为“即将推出”的钱包也不会被激活。 如需了解当前公布的费率,请参阅数字 ID 钱包定价。

用户需要做什么

您的页面或应用直接向 Google Wallet 发起请求:没有重定向,也没有 Didit 托管页面。 在用户操作(用户手势)触发时,将 next_action.digital_credentials.request 传给 navigator.credentials.get({digital: request}),并且在您发起时所用的 origin 上执行;或将其作为 GetDigitalCredentialOption 传给 Android Credential Manager。 然后将钱包返回的内容发送至提交钱包响应。 当钱包位于其他设备上时,浏览器会提供其自身的二维码。

接收结果

请按照数字 ID 钱包 API 指南跟踪验证进度并获取结果。 只有已完成且已验证的结果,才能作为钱包已验证该人员身份的证明。 不同钱包返回的身份属性各不相同;请勿假设地址、肖像或所有请求的属性都会返回。

相关内容

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 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 源(其 host 必须在应用的 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日