Godiddy Docs

Appearance

Verifier OID4VP Support ​

When creating an OID4VP Request, the input is a presentation definition identifier.

As a prerequisite, a configuration value with key oid4vp has to be set according to Verifier Configuration.

API Reference ​

See API Reference.

Create an OID4VP Presentation Request ​

The following request will return an OID4VP Presentation Request.

Request ​

Example:

bash
curl -X GET "https://api.godiddy.com/1.0.0/universal-verifier-oid4vp/v1/authorization/authorize?presentationDefinitionIds=EuPid2023_sd_jwt" \
     -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0"

The URL query parameter presentationDefinitionIds is an array of presentationDefinitions keys configured in the Verifier Configuration. This example will create a presentation request for the EuPid2023_sd_jwt. To request multiple credential presnetations, provide a comma-separated list of presentationDefinitionIds. Example : ?presentationDefinitionIds=EuPid2023_sd_jwt,AnotherPresentationDefinitionId

Response ​

Example:

json
{
  "authorizationRequestUrl": "openid://?request_uri=https//...",
  "state": "c5fcb846-1365-49a2-bcc7-06f0c15d4aeb",
  "verificationResultUrl": "https://api.godiddy.com/1.0.0/universal-verifier-oid4vp/v1/authorization/verification-result/c5fcb846-1365-49a2-bcc7-06f0c15d4aeb"
}

Fields:

  • authorizationRequestUrl: OID4VP authorization request URL.
  • state : State of the authorization request.
  • verificationResultUrl: URL to get the result of the OID4VP verification request.

Track the OID4VP Credential Verification ​

The OID4VP Presentation Request API will respond with the verificationResultUrl endpoint. This can be used to track the verification status of the presentation. When the holder presents a VP and verification is success this endpoint will return the disclosed claims.

Request ​

bash
curl -X GET "https://api.godiddy.com/1.0.0/universal-verifier-oid4vp/v1/authorization/verification-result/c5fcb846-1365-49a2-bcc7-06f0c15d4aeb"
     -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0"

Response ​

Fields:

  • verified: Verification result of the VP. Boolean value of true or false.
  • claims: Claims from the credentials presented for verification. When the presentation is verified the value is map of <key,value> pairs. The key denotes each requested presentationDefinitionId and value is claims of the credential presented by the wallet/user.
  • status: Status of the verification process. Values are FINISHED, PENDING or FAILED.

PENDING state: The value is PENDING until the holder presents the VC ​

Example:

json
{
  "status": "PENDING",
  "verified": false,
  "claims": null
}

FINISHED state: Once the holder performs the verification the state will be changed to FINISHED ​

A successful verification will return disclosed claims for each presented credential.

Example:

json
{
  "status": "FINISHED",
  "verified": true,
  "claims": {
    "EuPid2023_sd_jwt": {
      "sub": "did:jwk:eyJhbGciOiJFUzI1NiIsInVzZSI6InNpZyIsImt0eSI6IkVDIiwiY3J2IjoiUC0yNTYiLCJ4IjoiRFM0UDBENzdtSjBqTEVpR3FRMnJxTjNfOGJxM3FwcUVOUlczX3BOZGFZOCIsInkiOiJiY2pieWd4Um1CODFoc3BfZDBRQzNadVJ3T0FaNkJ0M0ZVcUVCaG9TTWtzIn0",
      "nbf": 1737299848,
      "iss": "did:key:zDnaetFfmqyM8dDpQNizCef9k8HGbHKx6d1bnCvV1daqynDPg",
      "iat": 1737299848,
      "vc": {
        "credentialSubject": {
          "givenName": "JOHN",
          "familyName": "SMITH",
          "gender": "Male",
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgVn/2Q==",
          "residentSince": "2015-01-01",
          "lprCategory": "C09",
          "lprNumber": "000-000-204",
          "commuterClassification": "C1",
          "birthCountry": "Bahamas",
          "birthDate": "1958-08-17",
          "id": "did:jwk:eyJhbGciOiJFUzI1NiIsInVzZSI6InNpZyIsImt0eSI6IkVDIiwiY3J2IjoiUC0yNTYiLCJ4IjoiRFM0UDBENzdtSjBqTEVpR3FRMnJxTjNfOGJxM3FwcUVOUlczX3BOZGFZOCIsInkiOiJiY2pieWd4Um1CODFoc3BfZDBRQzNadVJ3T0FaNkJ0M0ZVcUVCaG9TTWtzIn0"
        },
        "type": ["VerifiableCredential", "PermanentResidentCard"],
        "@context": [
          "https://www.w3.org/2018/credentials/v1",
          "https://w3id.org/citizenship/v1"
        ],
        "issuer": {
          "image": "https://uniissuer.io/images/logo.jpg",
          "name": "Universal Issuer",
          "id": "did:key:zDnaetFfmqyM8dDpQNizCef9k8HGbHKx6d1bnCvV1daqynDPg"
        },
        "issuanceDate": "2025-01-19T15:17:28Z"
      }
    }
  }
}