x-access-token header. Every wallet-scoped operation is called against the account’s wallet: store the wallet id on the account (wallet_id) or pass walletId in the plugin options (create one with wallets.create, or read the id from the dashboard).
Listing wallets needs no wallet id. Issuance offers and verification sessions are created as sessions that a holder wallet completes; poll issuance.getSession or verification.getSession, or listen for the openid4vc.* webhooks (the createSubscription response carries the signatureSecret used to verify deliveries).
This plugin covers the OpenID4VC routes of the published OpenAPI specification. The DIDComm routes, certificates and CSRs, keys and key backends, OAuth clients, attribute providers, authorization servers, mDoc and AnonCreds credential templates, mediator and messaging routes, and wallet profiles are documented by Paradym but not part of this plugin.
Every operation is described in the official OpenAPI specification: https://api.paradym.id/openapi.json
What you get:
- 33 typed API operations
- 1 incoming webhook event types
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Paradym API key before the first call: More: API Key
pnpm corsair setup --plugin=paradym --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List issuance sessionsWebhooks
This plugin registers 1 webhook event type. Configure the provider to POST to your Corsair HTTP handler, then usewebhookHooks on the plugin factory.
See Webhooks for every event path and payload shape, and Webhooks concept for routing.
What’s next
API reference
Every
paradym.api.* operation with input and output types.Webhooks
Event paths, payloads, and
webhookHooks examples.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.