What changes in your code
Sandbox and production apps use the same v2 URLs. The credentials select the app. See Apps & Environments.
The v2 OIDC issuer is
https://connect.hopae.com when you call connect.hopae.com. If you keep calling sandbox.connect.hopae.com, the issuer is https://sandbox.connect.hopae.com. See OIDC Integration.v1 request
v2 request
What changes in the result
user and match are unchanged. Check these details:
provenanceandmissing_claimsare opt-in: addprovenance=trueandmissing_claims=trueto the userinfo request.- Provider ids are catalog ids (
smart-id, notsmartid), and there is noamr. The connection that ran is inprovenance._metadata. provenance.presentation.credentials[]holds only the source’sclaimsandevidence.source_idis returned only when Source ID is ticked on the workflow’s Claims tab, or whenrequestedClaimslists it.- Errors use one envelope:
{ "error": { "code", "message" }, "request_id" }. - A finished verification is
completedorfailed, andresult.codesays how it ended. Read userinfo only when it isRECEIVED. See Result Codes.
Webhooks
Turn on the Webhook v2 endpoint under Developers → Webhooks when your receiver handles the v2 format, then turn Webhook v1 off. You can run both while you switch. See Webhooks.Step by step
1
Find your connections
Look up the connection ID for each v1 provider you use (below), and check that it is activated and enabled in the workflow.
2
Set the claims
Set the claims you sent in
requestedClaims on the workflow’s Claims tab, or keep sending requestedClaims. A non-empty list replaces the workflow’s claims. See Workflows.3
Update your code and test with a sandbox app
Apply the changes above and run the flow with test credentials. See Sandbox Testing.
4
Switch production
Deploy the same changes with your production app’s credentials.
Finding your connections
A v1providerId corresponds to a v2 provider, and a provider offers one connection per credential it can present. Most v1 providers become one connection. us-id-pass covered Google Wallet passports from several countries, so it becomes one connection per country.
For each v1 provider you use, find its connections in the table below. Then activate them under Configuration → Connections in the Console and enable them in your workflow. Get Connections returns connectionId, provider.id, and credential.id for each.
Instead of
connectionId, a v2 request can name providerId (with an optional credentialId). That is the v2 provider.id from Get Connections, which can differ from the v1 providerId. See Create Verification.
If a v1 provider you use is not listed, ask support@hopae.com with its
providerId.
