Webhooks

Overview

Webhooks are HTTP callbacks that notify your application about events on the didx:me platform, removing the need to poll the API for status updates.

Supported events

For Issuers
For Verifiers

Event	Description
`openid4vc.issuance.offered`	Credential offer sent to user
`openid4vc.issuance.completed`	Credential in pending state in wallet (openid4vc session completed)
`openid4vc.issuance.failed`	Issuance attempt failed
`openid4vc.issuance.expired`	Credential offer expired
`wallet.credential.accepted`	User accepted credential in wallet
`wallet.credential.rejected`	User rejected credential

Event	Description
`openid4vc.presentation.requested`	Presentation request created
`openid4vc.presentation.verified`	User presented credentials successfully
`openid4vc.presentation.failed`	Verification attempt failed
`openid4vc.presentation.expired`	Presentation request expired
`wallet.presentation.accepted`	User accepted presentation request
`wallet.presentation.rejected`	User rejected presentation request

Registering a webhook endpoint

curl -X POST "https://test.didxtech.com/me-creds/api/v1/endpoints" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-domain.com/webhooks/credentials"
  }'

Response (201 Created)

{
  "data": {
    "id": "du398r0fqd",
    "url": "https://your-domain.com/webhooks/credentials",
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-01T00:00:00.000Z"
  }
}

Webhook payload structure

All webhook payloads include an eventType and a payload with a resource reference:

{
  "eventType": "openid4vc.issuance.completed",
  "payload": {
    "openId4VcIssuanceId": "cmfwfjxdq003js601bmgy9tva"
  }
}

Technical requirements

Your webhook endpoint must:

Accept POST requests.
Use HTTPS exclusively.
Respond promptly with a 2xx status code.
Handle duplicate deliveries. The platform may retry on failure.
Be idempotent. Processing the same event twice should produce the same result.

Local development

Use ngrok to expose your local server via a public HTTPS URL during development:

ngrok http 3000

Register the resulting https:// ngrok URL as your webhook endpoint. The platform retries failed deliveries automatically.

Overview

User Onboarding

Issuance

Verification

Custom Templates (advanced)

Errors

Webhooks

Overview

Supported events

Registering a webhook endpoint

Response (201 Created)

Webhook payload structure

Technical requirements

Local development

​Overview

​Supported events

​Registering a webhook endpoint

​Response (201 Created)

​Webhook payload structure

​Technical requirements

​Local development

Overview

Supported events

Registering a webhook endpoint

Response (201 Created)

Webhook payload structure

Technical requirements

Local development