Credential Issuance

Initiate the OpenID4VCI protocol to issue a Verifiable Credential.

loading...

POST

/wallets/{walletId}/issue/initiate

Send

Path

Header

Body

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 /wallets/{walletId}/issue/{issuanceSessionId}/session-status API.

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

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

Path Parameters

Header Parameters

Response Body

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": "Unauthorized access to wallet service is not allowed."
}

{
  "message": "User user:9d18dc5a409e4f0f94ff6812e324c959 unauthorized for Wallet f5d223f6-fc41-42b1-b2a6-475a2984486c"
}

{
  "message": "Internal Server Error"
}