Skip to main content

Overview

The final step in the issuance workflow is delivering the credential offer to the user’s wallet. This endpoint sends an email to the user that triggers automatic delivery of the credential to their wallet app.

Endpoint

POST https://test.didxtech.com/me-wallet/api/orgs/credentials

Request

curl -X POST "https://test.didxtech.com/me-wallet/api/orgs/credentials" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "credentialOffer": "https://paradym.id/invitation?credential_offer_uri=...",
    "recipient": "[email protected]"
  }'

Request Body

FieldTypeDescription
credentialOfferstringThe offerUri returned from Step 3
recipientstringThe user’s email address

Response

HTTP 201 Created The endpoint returns a 201 Created status upon successful submission with no response body.

What Happens Next

  1. An email is sent to the user’s email address
  2. The email triggers automatic delivery of the credential to their wallet
  3. The credential appears as pending in the user’s wallet interface
  4. The user can accept or reject the credential from their wallet
The issuance workflow is complete! The user will receive their credential in their wallet.

Troubleshooting

If the credential doesn’t arrive, check:
  • The recipient email matches the user’s registered email
  • The credentialOffer URI is the exact value returned from Step 3 (not the QR variant)
  • The user has the didx:me wallet app installed and linked to their email