Pause, Resume & Cancel

curl -X POST https://sandbox.api.prava.space/v1/mandates/mdt_123/pause \
  -H "Authorization: Bearer sk_test_..."

curl -X POST https://sandbox.api.prava.space/v1/mandates/mdt_123/resume \
  -H "Authorization: Bearer sk_test_..."

curl -X POST https://sandbox.api.prava.space/v1/mandates/mdt_123/cancel \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.post(
    "https://sandbox.api.prava.space/v1/mandates/mdt_123/pause",
    headers={"Authorization": "Bearer sk_test_..."},
)

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

{ "id": "mdt_123", "status": "paused", "state": "available", "merchantScope": "listed", "approvedAmount": "40.00", "currency": "USD" }

{
  "error": { "code": "MANDATE_FORBIDDEN", "message": "Caller does not own this mandate" }
}

{
  "error": { "code": "MANDATE_INVALID_TRANSITION", "message": "The mandate's current status forbids this action" }
}

Three lifecycle actions change a mandate’s status. Each is a POST to the mandate by id, takes no body (dashboard callers pass dashboard_user_id), and returns the updated mandate. POST /v1/mandates/{id}/pause · /resume · /cancel — control-plane operations.

Endpoints

Action	Endpoint	Allowed from	Result
Pause	`POST /v1/mandates/{id}/pause`	`active`	`paused` — no charges until resumed
Resume	`POST /v1/mandates/{id}/resume`	`paused`	`active`
Cancel	`POST /v1/mandates/{id}/cancel`	`active`, `paused`	`cancelled` (terminal) — stops all future charges

Path parameters

string

required

The mandate id.

Response

Returns the updated mandate object (see List Mandates).

Notes

Legal transitions only: pause from active, resume from paused, cancel from active or paused. Any other transition returns 409 MANDATE_INVALID_TRANSITION.
cancel is terminal and local to Prava — it revokes the authorization so no further charges can be minted. Past charges are unaffected.
Only the mandate’s owner can act on it — a mismatched caller gets 403 MANDATE_FORBIDDEN.
The same actions are available to owners in the dashboard at pay.prava.space and to agents via prava mandate cancel / the MCP tools.

Error responses

Status	Code	Cause
403	`MANDATE_FORBIDDEN`	Caller does not own this mandate
409	`MANDATE_INVALID_TRANSITION`	The mandate’s current status forbids this action

curl -X POST https://sandbox.api.prava.space/v1/mandates/mdt_123/pause \
  -H "Authorization: Bearer sk_test_..."

curl -X POST https://sandbox.api.prava.space/v1/mandates/mdt_123/resume \
  -H "Authorization: Bearer sk_test_..."

curl -X POST https://sandbox.api.prava.space/v1/mandates/mdt_123/cancel \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.post(
    "https://sandbox.api.prava.space/v1/mandates/mdt_123/pause",
    headers={"Authorization": "Bearer sk_test_..."},
)

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

{ "id": "mdt_123", "status": "paused", "state": "available", "merchantScope": "listed", "approvedAmount": "40.00", "currency": "USD" }

{
  "error": { "code": "MANDATE_FORBIDDEN", "message": "Caller does not own this mandate" }
}

{
  "error": { "code": "MANDATE_INVALID_TRANSITION", "message": "The mandate's current status forbids this action" }
}

Get a Mandate Errors

Server-Side API

Reference

Endpoints

Path parameters

Response

Notes

Error responses

​Endpoints

​Path parameters

​Response

​Notes

​Error responses

Endpoints

Path parameters

Response

Notes

Error responses