Skip to main content
POST
cURL

Body

application/json

Request body for POST /auth/token/refresh.

refresh_token
string
required

Opaque refresh token previously issued by /auth/token or /auth/token/refresh.

Required string length: 53
Pattern: ^r1rt_[0-9a-f]{48}$

Response

Successful Response

Standard success envelope. Every successful response has this shape, with the operation's own payload under data.

data
TokenResponse · object | null

The operation's result. Its shape is documented per operation; omitted on responses that carry no payload.

message
string | null

Optional human-readable note. Omitted from the response when not set, which is the case for every payment operation today. Never parse it.

request_id
string | null

Correlation ID for this HTTP request, for logs and support. Send your own in the X-Request-Id header (letters, digits and hyphens, up to 36 characters -- other characters are stripped) or the gateway generates one. This is NOT the request_id idempotency key you send in a transaction body; the two are unrelated.

status
string
default:ok

Always ok on a successful (2xx) response. Errors use a different body shape entirely (RFC 9457 problem details), so branch on the HTTP status code, not on this field.

Last modified on September 15, 2026