Create an OpenID4VCI credential offer
Creates an OpenID4VCI credential offer. Authbound resolves project context from the secret key and forwards to the Authbound issuer using internal service authentication. Customer-controlled deployments require credentialDefinitionId and validate claims against that definition; InTime mode only. Idempotency-Key is required. In customer-controlled M4.1, Deferred returns unsupported_issuance_option with param=issuance_mode. The standard media schema describes hosted deployments; customer-controlled deployments use the schema referenced by x-authbound-customer-controlled-schema.
Enabled isolated testbed: omit all API credential headers to create without a key. Anonymous retries ignore Idempotency-Key. Both creation routes share 20/minute and 300/hour across testers. The enabled testbed caps raw bodies at 256 KiB before authentication, even for supplied keys (413).
Authorizations
Server-side secret key header. Format: sk_live_* (production) or sk_test_* (testing).
Headers
255Body
- Option 1
- Option 2
Hosted create offer contract. The customer-controlled deployment uses CustomerControlledCreateOpenId4VcIssuanceOfferRequest.
Approved Authbound credential definition ID
"pension_credential_v1"
Credential claims. Use nested objects for nested claim paths.
{
"Person": {
"given_name": "Sergio",
"family_name": "Jack"
},
"Pension": { "startDate": "2025-01-01T00:00:00.000Z" }
}SD-JWT VC type identifier resolved by the issuer
"urn:vc:authbound:pension:1.0"
InTime, Deferred Optional transaction code. Authbound maps this to the issuer PIN.
openid-credential-offer://, haip:// Customer metadata accepted by the public contract.
Response
Issuance offer created
Hosted issuance resource. The customer-controlled deployment uses CustomerControlledOpenId4VcIssuance.
openid4vc_issuance "iss_123"
offer_created, ready_to_issue, token_issued, credential_issued, canceled, expired, failed "pension_credential_v1"
Wallet deep link URI
URI to encode as a QR code
InTime, Deferred Customer metadata stored with the issuance session.