Skip to main content

CredentialOffer

offerIduuid

Unique identifier for this offer.

Example: 550e8400-e29b-41d4-a716-446655440000
offerUrlstring

OID4VCI offer URL — present this to the holder, typically as a QR code.

Example: openid-credential-offer://...?credential_offer=...
qrCodeDataUrlstring

Pre-rendered base64-encoded PNG QR code of the offer URL (data:image/png;base64,...). Render it directly in an <img> tag — no QR library needed.

Example: data:image/png;base64,iVBORw0KGgo...
statusstring

Always pending at creation.

Possible values: [pending]

Example: pending
createdAtdate-time

Offer creation timestamp (ISO 8601).

Example: 2025-01-15T10:00:00Z
expiresAtdate-time

Offer expiry timestamp (ISO 8601).

Example: 2025-01-15T10:05:00Z
credentialConfigurationIdstring

Echo of the credential configuration.

Example: VerifiedPerson_vc+sd-jwt
credentialTypestring

Resolved credential type URN.

Example: VerifiedPerson
externalIdstring

Echo of your provided externalId.

Example: order-12345
walletResponseUrluri

URL the holder's wallet POSTs to, unchanged, to accept or reject the offer. It contains the offer's wallet response token — treat it as a secret.

Example: https://iaas.stg.iden2.app/api/v1/wallet/offers/550e8400-e29b-41d4-a716-446655440000/response?token=...
credentialIdstring

The credential's registry ID (urn:uuid: form), assigned when the offer is created. Use it to revoke the credential after issuance.

Example: urn:uuid:7c9e6679-7425-40de-944b-e07fc1f90ae7
CredentialOffer
{
  "offerId": "550e8400-e29b-41d4-a716-446655440000",
  "offerUrl": "openid-credential-offer://...?credential_offer=...",
  "qrCodeDataUrl": "data:image/png;base64,iVBORw0KGgo...",
  "status": "pending",
  "createdAt": "2025-01-15T10:00:00Z",
  "expiresAt": "2025-01-15T10:05:00Z",
  "credentialConfigurationId": "VerifiedPerson_vc+sd-jwt",
  "credentialType": "VerifiedPerson",
  "externalId": "order-12345",
  "walletResponseUrl": "https://iaas.stg.iden2.app/api/v1/wallet/offers/550e8400-e29b-41d4-a716-446655440000/response?token=...",
  "credentialId": "urn:uuid:7c9e6679-7425-40de-944b-e07fc1f90ae7"
}