Create Credential Offer
POST/api/v1/iaas/credential-offers
Creates a new OID4VCI credential offer. Returns an offer URL that is typically rendered as a QR code for holder wallet consumption.
After creating the offer, display the qrCodeDataUrl (or render offerUrl with your own QR library) and poll GET /api/v1/iaas/credential-offers/{offerId} every 3–5 seconds until the credential is issued (claimedAt is present) or the offer ends (rejected, expired or revoked) — see Get Offer Status for the states.
Pass the returned walletResponseUrl to the holder's wallet unchanged: it carries the token the wallet needs to signal accept or reject.
See the Issuance Integration Guide for the full flow and SD-JWT & Selective Disclosure for the selectiveDisclosure configuration.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 500
- 501
- 503
Credential offer created.
Invalid request — malformed JSON, missing required field, or selectiveDisclosure keys don't match credentialData keys.
Authentication required — missing, invalid, or expired access token.
Issuer not authorized — your token lacks the required scope, or your configuration is not permitted to issue this credential type.
Credential configuration not found — credentialConfigurationId does not exist.
Internal server error — platform error. Retry with exponential backoff.
Not implemented — the credential configuration uses a format this endpoint does not support.
Backend unavailable — downstream dependency unavailable. Retry.