Send verification request (v3)
POST/v3/config/digital-wallet/openid/sdjwt/verification/send
This endpoint is used to send verification request based on OID4VP specification.
Request
- application/json
Body
If true, then the Authorization Request must be resolved by a URI and the URI is specified in request_uri
query parameter in openid4vp:// wallet invocation link.
Identifier for the presentation definition ID
transactionData object
The url prefix to be used for authorisation request, default value is openid4vp://?
The identifier of the individual. If specified, the verifier will send the request directly to the configured individuals device.
Responses
- 200
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
verificationHistory object
Identifier for the presentation definition
Authorization Request defined as per OID4VP draft 20 specification.
presentationSubmission objectrequired
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
presentation_submission objectrequired
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
descriptor_map object[]required
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
path_nested objectrequired
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
For further reference, please visit: https://identity.foundation/presentation-exchange/#presentation-submission
Possible values: [request_sent
, request_received
, presentation_acked
]
It support 3 presentation request statuses: 1. request_sent: Indicates the presentation request has been sent to the holder. 2. request_received: Indicates the presentation request has been received/scanned by the holder. 3. presentation_acked: Indicates the presentation submission from holder is received by the verifier.
Validate signatures as well as the presentation submission against the presentation definition.
Timestamp when the record was created.
Timestamp when the record was updated.
Identifier for the presentation definition
holder objectrequired
Contains the metadata describing a holder. For e.g. Name, location, logo e.t.c
Identifier of the holder. For .e.g. DID or Name obtained from client metadata if available.
Specifies the wallet unit attestation credential.
Specifies the wallet unit attestation pop credential.
Specifies the wallet unit attestation credential is verified.
The credential being presented to the verifier
The verifiable credential jwt being presented to the verifier
transactionData object
The base 64 encoded value of the transaction data.
Specifies comprehensive information about the validity of the presentation
Specifies comprehensive information about the validity of the presented wallet unit attestation
Possible values: [redirect_uri
, did
, verifier_attestation
, x509_san_dns
]
Defines the client id scheme for the verification
Defines the redirect uri for the verifier
Possible values: [direct_post
, direct_post.jwt
]
Defines the response mode to be used for verification
The identifier of the individual which the verification request is send to
{
"verificationHistory": {
"presentationExchangeId": "string",
"vpTokenQrCode": "string",
"presentationSubmission": {
"presentation_submission": {
"definition_id": "string",
"descriptor_map": [
{
"format": "string",
"id": "string",
"path": "string",
"path_nested": {
"format": "string",
"id": "string",
"path": "string"
}
}
],
"id": "string"
}
},
"status": "request_sent",
"verified": true,
"createdAt": 0,
"updatedAt": 0,
"presentationDefinitionId": "string",
"holder": {
"name": "string"
},
"walletUnitAttestation": "string",
"walletUnitAttestationPoP": "string",
"walletUnitAttestationVerified": true,
"presentation": [
{}
],
"vpTokenResponse": [
"string"
],
"transactionData": {},
"transactionDataBase64": "string",
"presentationValidity": [
{}
],
"walletUnitValidity": [
{}
],
"clientIdScheme": "redirect_uri",
"directPostRedirectUri": "string",
"responseMode": "direct_post",
"verifierAttestation": "string",
"individualId": "string"
}
}