Skip to main content

Onboarding

The Core API onboarding process is designed to help issuers gain access to the API and integrate it into their systems. This guide outlines the steps for onboarding and starting to use the Core API.

Step 1: Request Access to the Core API​

  1. Submit an Access Request:

    • Contact our support team.
    • Provide the following details:
      • Organization name
      • Contact information
      • Intended use case
      • Required credential types

  2. Access Approval:

    • Our team will review your request and provide credentials upon approval.

  3. Receive Credentials:

    • You will receive credentials (such as email and one-time password) for the Core API management portal.

  4. Generate Client ID and Secret:

    • Use the management portal to generate your application’s client ID and secret.

Step 2: Configure Your Integration​

Set up your application according to the integration guide provided by email. Detailed documentation is available in our OpenAPI document.

Core API Workflow​

Once you have access, the typical workflow for issuing verifiable credentials using OpenID for Verifiable Credential Issuance 1.0 (OID4VCI) is as follows:

  1. Integrate with the Core API:

    • Integrate your backend system with the Core API using the provided documentation and API credentials.
    • Alternatively, use the pre-authorized credential offer flow if you do not require dynamic integration.

  2. Create a Credential Offer:

    • Your system creates a credential offer for the consumer (EUDI wallet), either dynamically via API or using a pre-authorized offer.

  3. Distribute the Offer:

    • The credential offer is delivered to the consumer, typically as a QR code or deep link.

  4. Wallet Interaction:

    • The consumer scans the QR code or follows the link with their EUDI wallet, which initiates the OID4VCI flow.

  5. Credential Issuance:

    • The wallet authenticates and requests the credential from the Core API.
    • The Core API issues the verifiable credential to the wallet, following the OID4VCI protocol.

  6. Completion:

    • The consumer receives and stores the verifiable credential in their EUDI wallet.

By following these steps, issuers can onboard and leverage the Core API to issue verifiable credentials to EUDI wallets in a secure and standards-compliant manner.