Verify credentials

Create a presentation template

To use Paradym to verify information from a holder you'll first need to create a presentation template. A presentation template defines what attributes and/or information the holder should present as proof. Once created, a template can be used to request as many presentations as you want.

When creating your presentation template you are basically making the blueprint for a presentation request that can be re-used. The main thing you need to know before creating a template are:

• The credential format and type of the credential(s) you want to request
• The allowed issuer(s)
• The specific attributes you want to request
• [Optional] Any requirements the specific attributes need to match

Note that it is currently not possible to combine multiple credential formats in a single presentation template. In the future this will be possible, but for now you have to decide which credential format to request, and this will also influence the exchange protocol to use for the request. Based on the format that is going to be used for issuance of the credential, you need to use the same format for verification of the credential:

• sd-jwt-vc with OpenID4VC Verification (opens in a new tab).
• anoncreds with DIDComm Verification (opens in a new tab).

We recommend to always set the allowed issuers on a presentation template, as EVERYONE can issue a credential based on a certain credential type. It is the issuer of the credential that determines whether you trust or accept it. If you don't configure the issuers on a presentation template, YOU MUST verify the issuer property of a submitted credential afterwards and ensure you trust the issuer of that credential. If you're verifying a credential from your own project, you can see what issuer method the credential template uses on the template (in the API or in the Dashboard), and then in the Settings -> Profile tab, or using the DID API (opens in a new tab) you can find the DID associated with the template.

If you're verifying a credential issued by one or more issuer(s) that is not yourself, you need to get hold of the following information to be able to verify credentials issued by them:

• The credential format. Paradym supports anoncreds or sd-jwt-vc
• The issuer value(s). Paradym supports did:cheqd:testnet, did:cheqd:mainnet and did:web DIDs.
• The attributes of the credential. For Anoncreds you can request string and number values. For sd-jwt-vc you can also request date and boolean values.

{
  "name": "Verify membership status",
  "description": "This information is requested to verify if you are still and active member",
  "credentials": [
    {
      "description": "These attributes are requested to verify your paradym membership",
      "name": "Request for Paradym MemberCard",
      "format": "sd-jwt-vc",
      "type": "https://metadata.paradym.id/types/28dc88-MemberCard",
      "issuers": [
        "did:web:metadata.paradym.id:a04629bd-9be6-4892-8fd9-34fd7f250182"
      ],
      "attributes": {
        "first_name": {
          "type": "string",
          "value": "myValue"
        },
        "loyalty_points": {
          "type": "number"
        },
        "active": {
          "type": "boolean",
          "value": true
        }
      }
    }
  ]
}

{
  "name": "Verify membership status",
  "description": "This information is requested to verify if you are still and active member",
  "credentials": [
    {
      "description": "These attributes are requested to verify your paradym membership",
      "name": "Request for Paradym MemberCard",
      "format": "anoncreds",
      "schema": "did:cheqd:testnet:fb8a3467-a72d-41d7-bde0-50c85febbef4/resources/efd5749c-fff5-4dfc-9e30-d75ec92f15da",
      "issuers": [
        "did:cheqd:testnet:fb8a3467-a72d-41d7-bde0-50c85febbef4"
      ],
      "attributes": {
        "first_name": {
          "type": "string"
        },
        "loyalty_points": {
          "type": "number",
          "minimum": 500
        },
        "active": {
          "type": "number",
          "value": 1
        }
      }
    }
  ]
}

Use a presentation template to verify a credential

The Paradym API currently supports issuing and verifying SD-JWT credentials over OpenID4VC, or Anoncreds credentials over DIDComm. Read more about the different standards and protocols.

Based on the credential format you selected in the presentation template, you should either request a presentation over DIDComm or OpenID4VC:

• SD-JWT VC (sd-jwt-vc) with OpenID4VC Verification (opens in a new tab).
• Anoncreds (anoncreds) with DIDComm Verification (opens in a new tab).

{
  "presentationTemplateId": "clu129ps200043eghxvhz22m1"
}

{
  "id": "clu6p64z80001c7xudvp2uvts",
  "authorizationRequestUri": "https://paradym.id/invitation?request_uri=https%3A%2F%2Fparadym.id%2Foid4vp%2Fa744eefb-f7e6-444d-8a38-24c0136e893e%2Fauthorization-requests%2F215d6f1a-14fd-47bc-86c8-2b707124718d",
  "status": "requested",
  "presentationTemplateId": "clu129ps200043eghxvhz22m1",
  "credentials": [],
  "createdAt": "2023-01-03T00:00:00.000Z",
  "updatedAt": "2023-01-03T00:00:00.000Z",
  "error": null
}

View your verification requests