> ## 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. # Enviar respuesta de wallet de credenciales digitales > Envía a Didit la respuesta de credencial que devolvió una wallet de la Digital Credentials API, como Google Wallet, para que decida la verificación. Usa esta operación para una wallet cuya respuesta de inicio incluye `next_action.type = request_digital_credential`, como Google Wallet. Autentícate desde tu backend con la clave de API de la aplicación que inició la verificación. Envía exactamente lo que devolvió la wallet: `{protocol, data}` de `navigator.credentials.get` en el navegador, o el `credentialJson` ya analizado de Android Credential Manager. La respuesta está cifrada para Didit, así que no la modifiques. Didit comprueba la firma del emisor con sus raíces de emisores de confianza, cada valor devuelto con su resumen firmado y la firma del dispositivo que abarca tu `origin` y esta solicitud, y luego decide el resultado de la verificación. Una respuesta solo se puede enviar una vez. Un segundo envío devuelve la verificación que ya se decidió. Una verificación que no admite una respuesta de wallet responde `409` con `error: "not_a_digital_credentials_wallet"`. Consulta [API de wallets de identidad digital](https://docs.didit.me/es/standalone-apis/digital-id-wallets.md#wallets-de-digital-credentials-google-wallet) para ver la secuencia completa, incluidos los fragmentos de código para navegador y Android. ## OpenAPI ````yaml es/openapi-25.json POST /v3/id-verification/wallets/verifications/{request_id}/response/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificación de identidad. Autentícate con el encabezado x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/id-verification/wallets/verifications/{request_id}/response/: post: tags: - Digital ID wallets summary: Enviar una respuesta de wallet description: >- Wallets de la Digital Credentials API (Google Wallet): envía lo que la wallet devolvió a tu página o app para una verificación cuyo next_action es request_digital_credential. Didit lo descifra, comprueba la firma del emisor con las raíces de emisores de confianza, cada valor devuelto con su resumen firmado y la firma del dispositivo sobre tu origen y esta solicitud, y después decide la verificación: verified (se factura una vez) o declined con el código de error. De un solo uso: un segundo envío devuelve la verificación ya decidida. operationId: submit_wallet_verification_response parameters: - in: path name: request_id schema: type: string format: uuid description: El request_id que devolvió el endpoint de inicio. required: true requestBody: content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialResponseRequest example: response: protocol: openid4vp-v1-signed data: response: application/x-www-form-urlencoded: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialResponseRequest example: response: protocol: openid4vp-v1-signed data: response: multipart/form-data: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialResponseRequest example: response: protocol: openid4vp-v1-signed data: response: required: true responses: '200': 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: Approved outcome: verified error: null interaction: digital_credentials simulated: false expires_at: '2026-01-01T10:10:00Z' next_action: null identity: full_name: Alex Example first_name: Alex last_name: Example date_of_birth: '1990-01-31' nationality: USA issuing_state: USA attributes: document_number: X0000000 document_expiry_date: '2030-01-31' level_of_assurance: substantial verified_at: '2026-01-01T10:01:00Z' signature_valid: true 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: 'Errores de validación de campos ({field: [messages]}).' '403': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiClientCredentialsForbiddenErrorMessage description: 'Faltan las credenciales (x-api-key o Authorization: Bearer).' '404': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- error not_found: ninguna verificación de wallet de esta aplicación tiene este request_id. '409': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- error not_a_digital_credentials_wallet: esta verificación no acepta una respuesta de wallet. '503': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- error wallet_not_configured: este entorno no puede verificar la wallet. security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request POST \ --url https://verification.didit.me/v3/id-verification/wallets/verifications/REQUEST_ID/response/ \ --header 'x-api-key: YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "response": { "protocol": "openid4vp-v1-signed", "data": { "response": "" } } }' components: schemas: DigitalIdWalletApiWalletDigitalCredentialResponseRequest: type: object description: >- Lo que la wallet respondió a tu página o aplicación, en una verificación ``request_digital_credential``. properties: response: type: object additionalProperties: {} description: >- Exactamente lo que devolvió la wallet: el {protocol, data} de la DigitalCredential obtenida con navigator.credentials.get, o el credentialJson analizado de la DigitalCredential de Android. Está cifrado para Didit; no lo modifiques. required: - response DigitalIdWalletApiWalletVerificationResponse: type: object description: >- Una verificación de wallet independiente, tal como la devuelve cada endpoint de wallets. 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: El objeto de metadatos enviado al inicio, o 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' DigitalIdWalletApiClientCredentialsForbiddenErrorMessage: type: object properties: detail: type: string default: Forbidden - User doesn't have permission DigitalIdWalletApiWalletVerificationError: type: object properties: error: type: string description: Código estable legible por máquina, p. ej., wallet_unavailable. detail: type: string required: - detail - error DigitalIdWalletApiWalletVerificationResult: type: object properties: wallet: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWallet' readOnly: true country: type: string status: type: string description: >- Not Finished mientras está pendiente; después, Approved (verificado) o 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 una vez verificada la firma de la credencial; null para una simulada. 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: >- Errores de validación de la solicitud: cada campo rechazado con sus mensajes. additionalProperties: type: array items: type: string DigitalIdWalletApiWallet: type: object properties: id: type: string description: Id de catálogo de la wallet, p. ej., 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` - Pendiente * `verified` - Verificado * `cancelled` - Cancelado por el usuario * `timeout` - Tiempo de espera agotado * `failed` - Fallido 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: envía el navegador del usuario a url. confirm_in_app: muestra verification_code al usuario, que comprueba que coincide con el código de su app de wallet y confirma allí; después, consulta periódicamente el estado. request_digital_credential: en un gesto del usuario en el origen con el que empezaste, solicita la credencial a la wallet con digital_credentials.request y envía lo que devuelva a 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: 'Solo redirect: dónde inicia sesión el usuario con la wallet.' digital_credentials: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialsRequest description: >- Solo request_digital_credential: la solicitud que se debe entregar a la wallet. verification_code: type: string description: >- Solo confirm_in_app: el código de comparación de 4 dígitos que también muestra la app de la wallet. poll_interval_seconds: type: integer description: >- Solo confirm_in_app: con qué frecuencia llamar a POST .../verifications/{request_id}/poll/ para obtener una respuesta rápida. Didit también consulta en segundo plano los inicios de sesión pendientes, así que el webhook informa del resultado aunque no hagas consultas. 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: >- Nacionalidad ISO3, solo cuando la wallet la declara (nunca se infiere). issuing_state: type: string description: País ISO3 cuyo esquema emitió la identidad. 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: >- Pásalo tal cual: navigator.credentials.get({digital: request}) en el navegador, o JSON.stringify(request) como requestJson de GetDigitalCredentialOption en Android. Firmado por Didit para tu aplicación. required: - protocol - request securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: El token de acceso de credenciales de cliente de la aplicación. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.