Skip to content
Registry StackDocsDevelopment (unreleased)

Receive the wallet's direct_post.jwt response

POST
/v1/responses/{request_id}
curl --request POST \
--url https://example.com/v1/responses/example \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data error=example \
--data response=example \
--data state=example

Anonymous; the request identifier is a bearer capability. The form carries one encrypted response JWE, or a plain OAuth error. Answers use the OAuth error shape and never carry a description.

request_id
required
string
Media typeapplication/x-www-form-urlencoded
object
error
string
response

Compact JWE (ECDH-ES; A128GCM or A256GCM).

string
state
string

Example generated

error=example&response=example&state=example

The response was accepted; an empty object

Media typeapplication/json
object

Example generated

{}
Cache-Control
string
Allowed value: no-store
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.

The response was refused

Media typeapplication/json
object
error
required
Allowed values: invalid_request temporarily_unavailable

Example

{
"error": "invalid_request"
}
Cache-Control
string
Allowed value: no-store
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.

The configured request deadline elapsed

Media typeapplication/problem+json
object
detail
string
status
required
integer
title
required
string
type
required
string format: uri

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "https://example.com"
}
Cache-Control
string
Allowed value: no-store
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.

The body exceeds the response size limit

Media typeapplication/problem+json
object
detail
string
status
required
integer
title
required
string
type
required
string format: uri

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "https://example.com"
}
Cache-Control
string
Allowed value: no-store
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.

Responses are arriving too quickly

Media typeapplication/json
object
error
required
Allowed values: invalid_request temporarily_unavailable

Example

{
"error": "invalid_request"
}
Cache-Control
string
Allowed value: no-store
Retry-After
integer
>= 1
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.

The audit destination is stopped, the response is being recorded, or holding the presentation would pass the held-presentation byte budget

Media typeapplication/json
object
error
required
Allowed values: invalid_request temporarily_unavailable

Example

{
"error": "invalid_request"
}
Cache-Control
string
Allowed value: no-store
Retry-After
integer
>= 1
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.