Open ID 4 Verifiable Presentations

Submit authorization response

post

Submit an authorization response to a previously created presentation request.

This endpoint is called by the wallet to submit a Verifiable Presentation in response to an authorization request.

The submission can be in one of two forms depending on the response_mode of the original presentation request:

• direct_post: The vp_token and presentation_submission parameters are sent directly.

• direct_post.jwt: The response parameter contains a JWE-encrypted authorization response.

Exactly one of vp_token or response must be provided. Providing both or neither results in an error.

If the original presentation request included a verifier_redirect_uri, it is returned in the response as redirect_uri.

Supported Standards

• OpenID4VP 1.0

Path parameters

idstring · uuidRequired

Body

application/json

Exactly one of vp_token or response must be provided. Use vp_token with direct_post response mode. Use response (JWE) with direct_post.jwt response mode.

vp_tokenstringOptional

The Verifiable Presentation token. Required when response_mode is direct_post.

responsestringOptional

The JWE-encrypted authorization response. Required when response_mode is direct_post.jwt.

presentation_submissionstringOptional

JSON string containing the presentation submission mapping between requested credentials and the VP token.

statestringOptional

Opaque state value from the original presentation request.

Responses

200

Authorization response successfully submitted

application/json

redirect_uristringOptional

The verifier redirect URI to follow after submission, if configured in the original presentation request.

Example: https://verifier.example.com/callback?session=abc123

400Error

application/json

404Error

application/json

500Error

application/json

post/verifier/requests/{id}/responses

HTTPcURLJavaScriptPython

POST /verifier/requests/{id}/responses HTTP/1.1
Host: zyfla-wallet-sandbox.meeco.cloud
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "vp_token": "text",
  "response": "text",
  "presentation_submission": "text",
  "state": "text"
}

{
  "redirect_uri": "https://verifier.example.com/callback?session=abc123"
}

Get presentation request JWT

get

Retrieve the signed JWT representation of a presentation request.

This endpoint is typically called by the wallet after receiving an authorization request URI that contains a request_uri parameter pointing to this endpoint.

The response is the raw JWT string with content type application/oauth-authz-req+jwt.

Supported Standards

• OpenID4VP 1.0

Path parameters

idstring · uuidRequired

Responses

200

Presentation request JWT successfully loaded

application/oauth-authz-req+jwt

stringOptional

404Error

application/json

500Error

application/json

get/verifier/requests/{id}/jwt

HTTPcURLJavaScriptPython

GET /verifier/requests/{id}/jwt HTTP/1.1
Host: zyfla-wallet-sandbox.meeco.cloud
Accept: */*

text