FortID LogoFortID

Credential Issuance

Issue verifiable credentials from an issuer using OpenID4VCI.

Initiate the OpenID4VCI protocol to issue a Verifiable Credential.

POST
/wallets/{walletId}/issue/initiate

This API is intended to be called when being offered a credential from an issuer via the OpenID for Verifiable Credential Issuance protocol.

The caller needs to specify which Wallet will store the Credential. The Credential Offer should be set to the one received from the issuer.

The issuanceSessionId will be returned. Caller can check the status of this session using the /issue/{issuanceSessionId}/session-status API.

Once the consentRequest is ready (fetched with /issue/{issuanceSessionId}/session-status), the /issue/{issuanceSessionId}/consent API can be called to proceed with the protocol.

This endpoint currently supports only the Pre-Authorized Code Flow.

Path Parameters

walletId*string

The unique identifier of the Wallet.

Formatuuid

Header Parameters

Authorization*string

Token for authenticating requests to the FortID Wallet Service.

Request Body

application/json

credentialOffer*string

URI of the Credential Offer by reference or by value, as defined by the OpenID4VCI specification.

Response Body

application/json

application/json

application/json

curl -X POST "https://ews.fortid.com/wallets/f4856bb7-d77a-4a6a-9c8a-7d7f6f639cfb/issue/initiate" \  -H "Authorization: Bearer {access_token}" \  -H "Content-Type: application/json" \  -d '{    "credentialOffer": "openid-credential-offer://?credential_offer_uri=https%3A%2F%2Fserver%2Eexample%2Ecom%2Fcredential-offer%2FGkurKxf5T0Y-mnPFCHqWOMiZi4VS138cQO_V7PZHAdM"  }'
{
  "issuanceSessionId": "dd6473c2-2043-4523-b359-ceb596ddae66"
}
{
  "message": "Bad request: Invalid credential offer"
}
{
  "message": "Wallet with ID f4856bb7-d77a-4a6a-9c8a-7d7f6f639cfb not found"
}
Empty