Skip to content

Your First Integration

This guide walks you step by step through a complete flow: issuing a credential, receiving it in a test wallet, and presenting it to a Verifier.

Flow diagram

sequenceDiagram
    participant Your system
    participant Issuer API
    participant Wallet
    participant Verifier API

    Your system->>Issuer API: 1. Create credential offer
    Issuer API-->>Your system: credential_offer (URL/QR)
    Your system-->>Wallet: 2. Deliver offer to user
    Wallet->>Issuer API: 3. Redeem offer (OID4VCI)
    Issuer API-->>Wallet: SD-JWT VC credential
    Verifier API->>Wallet: 4. Request presentation (OID4VP)
    Wallet-->>Verifier API: Signed presentation
    Verifier API-->>Your system: 5. Verification result
Prerequisites before starting
  • Access to the sandbox. Request it at Sandbox. Environment URLs:
    • Issuer: https://sandbox-stg.eudistack.net/issuer
    • Wallet: https://sandbox-stg.eudistack.net/wallet
    • Verifier: https://sandbox-stg.eudistack.net/verifier
  • A valid Bearer Token (provided by the EUDIStack team when granting sandbox access).
  • Postman or curl.

Step 1: Create a credential (Issuer)

POST https://sandbox-stg.eudistack.net/issuer/api/v1/issuances
Content-Type: application/json
Authorization: Bearer {{token}}

{
  "credential_configuration_id": "learcredential.employee.sd.1",
  "payload": {
    "mandator": {
      "organizationIdentifier": "VATES-12345678A",
      "organization": "EUDIStack Demo",
      "commonName": "Admin User",
      "email": "admin@eudistack.com",
      "country": "ES"
    },
    "mandatee": {
      "firstName": "Mandatee",
      "lastName": "Test",
      "email": "mandatee-test@eudistack.com"
    },
    "power": [
      {
        "function": "Admin",
        "action": ["Execute"]
      }
    ]
  },
  "delivery": "ui",
  "email": "your-email@x.com",
  "grant_type": "urn:ietf:params:oauth:grant-type:pre-authorized_code"
}

{
  "credential_offer_uri": "openid-credential-offer://?credential_offer_uri=https://sandbox-stg.eudistack.net/issuer/oid4vci/v1/credential-offer/XXXX"
}

Step 2: Open the Credential Offer (Wallet)

  1. Copy the credential_offer_uri from the previous response.
  2. Go to the wallet: https://sandbox-stg.eudistack.net/wallet.
  3. Log in or create a wallet.
  4. Select "Scan credential".
  5. Paste the previously copied credential_offer_uri.

The Wallet will automatically interpret the offer.

Step 3: Credential redemption (OID4VCI)

If the flow is pre-authorized code:

  • The Wallet requests an activation code (tx_code).
  • Enter the code received by email.

Once validated:

  • The Wallet exchanges the pre-authorized_code for an access_token.
  • Downloads the signed credential from the Issuer.
  • Stores the credential in the user's Wallet.

Step 4: Start verification (OID4VP)

POST https://sandbox-stg.eudistack.net/verifier/api/v1/authorization-request

{
  "session_id": "abc123",
  "request_uri": "openid-vp://verifier/request/abc123",
  "expires_in": 120
}

Note: the session_id value is the {id} used in Option B: Polling (GET /api/v1/authorization-request/{id}) and as the state parameter in Option A SSE events.

Open the Wallet:

  1. Scan or copy the Verifier request.
  2. Select the credential to present.

Step 5: Retrieve verification result

There are two ways to obtain the result.

The Verifier sends the result to your redirect_uri once the Wallet completes the presentation:

POST /oid4vp/auth-response
Content-Type: application/x-www-form-urlencoded

The Verifier responds with a redirect:

{
  "redirect_uri": "https://your-app.com/callback?code=abc&state=xyz"
}

Query the verification status using the integrator-facing endpoint, with the session_id obtained in Step 4:

GET https://sandbox-stg.eudistack.net/verifier/api/v1/authorization-request/{id}
Authorization: Bearer {{token}}

{
  "session_id": "abc123",
  "status": "verified",
  "verified": true,
  "credential_type": "learcredential.employee.sd.1"
}

Do not confuse with the Wallet endpoint

GET /oid4vp/auth-request/{id} is a Wallet-facing OID4VP protocol endpoint used by the Wallet to retrieve the presentation request JWT. It is not a verification-status endpoint for integrators.

Next steps