Revoke Session

curl -X POST https://sandbox.api.prava.space/v1/sessions/sess_123/revoke \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.post(
    "https://sandbox.api.prava.space/v1/sessions/sess_123/revoke",
    headers={"Authorization": "Bearer sk_test_..."},
)

const resp = await fetch("https://sandbox.api.prava.space/v1/sessions/sess_123/revoke", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_test_...",
  },
});

{ "success": true }

{
  "error": { "code": "AUTH_1002", "message": "Missing or invalid Authorization header" }
}

{
  "error": { "code": "NOT_FOUND", "message": "Session not found" }
}

Revoke a payment session before it is used. Revocation is immediate and cannot be undone — a revoked session can no longer collect a card or produce credentials. POST /v1/sessions/{id}/revoke · Authenticated with your secret key.

Path parameters

string

required

The session_id returned by Create Session.

Response

boolean

Always true on successful revocation.

Notes

Once revoked, the session token can no longer be used for any SDK operations.
Any in-progress card collection or intent registration (the step that creates the payment’s spending permission) within the session will fail.
Revocation is immediate and irreversible.

Error responses

Status	Code	Cause
401	`AUTH_1001`	Invalid API key
401	`AUTH_1002`	Missing or invalid Authorization header
404	`NOT_FOUND`	Session not found or doesn’t belong to your merchant account

curl -X POST https://sandbox.api.prava.space/v1/sessions/sess_123/revoke \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.post(
    "https://sandbox.api.prava.space/v1/sessions/sess_123/revoke",
    headers={"Authorization": "Bearer sk_test_..."},
)

const resp = await fetch("https://sandbox.api.prava.space/v1/sessions/sess_123/revoke", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_test_...",
  },
});

{ "success": true }

{
  "error": { "code": "AUTH_1002", "message": "Missing or invalid Authorization header" }
}

{
  "error": { "code": "NOT_FOUND", "message": "Session not found" }
}

Server-Side API

Reference

Path parameters

Response

Notes

Error responses

​Path parameters

​Response

​Notes

​Error responses

Path parameters

Response

Notes

Error responses