curl -X POST https://sandbox.api.prava.space/v1/mandates/mdt_123/resume \
-H "Authorization: Bearer sk_test_..."
import requests
response = requests.post(
"https://sandbox.api.prava.space/v1/mandates/mdt_123/resume",
headers={"Authorization": "Bearer sk_test_..."},
)
const response = await fetch("https://sandbox.api.prava.space/v1/mandates/mdt_123/resume", {
method: "POST",
headers: { Authorization: "Bearer sk_test_..." },
});
{ "id": "mdt_123", "status": "active", "state": "available", "merchantScope": "listed", "approvedAmount": "40.00", "currency": "USD" }
{
"error": { "code": "MANDATE_INVALID_TRANSITION", "message": "The mandate's current status forbids this action" }
}
Mandate lifecycle
Resume a Mandate
Reactivate a paused mandate.
POST
/
v1
/
mandates
/
{id}
/
resume
curl -X POST https://sandbox.api.prava.space/v1/mandates/mdt_123/resume \
-H "Authorization: Bearer sk_test_..."
import requests
response = requests.post(
"https://sandbox.api.prava.space/v1/mandates/mdt_123/resume",
headers={"Authorization": "Bearer sk_test_..."},
)
const response = await fetch("https://sandbox.api.prava.space/v1/mandates/mdt_123/resume", {
method: "POST",
headers: { Authorization: "Bearer sk_test_..." },
});
{ "id": "mdt_123", "status": "active", "state": "available", "merchantScope": "listed", "approvedAmount": "40.00", "currency": "USD" }
{
"error": { "code": "MANDATE_INVALID_TRANSITION", "message": "The mandate's current status forbids this action" }
}
Resume a paused mandate so it can create new charges again. The request takes no body and returns the updated mandate.
POST /v1/mandates/{id}/resume
Path parameters
string
required
The mandate id.
Response
Returns the updated mandate withstatus: "active".
Notes
- Only a
pausedmandate can be resumed. Any other transition returns409 MANDATE_INVALID_TRANSITION. - Only the mandate’s owner can act on it; a mismatched caller gets
403 MANDATE_FORBIDDEN.
curl -X POST https://sandbox.api.prava.space/v1/mandates/mdt_123/resume \
-H "Authorization: Bearer sk_test_..."
import requests
response = requests.post(
"https://sandbox.api.prava.space/v1/mandates/mdt_123/resume",
headers={"Authorization": "Bearer sk_test_..."},
)
const response = await fetch("https://sandbox.api.prava.space/v1/mandates/mdt_123/resume", {
method: "POST",
headers: { Authorization: "Bearer sk_test_..." },
});
{ "id": "mdt_123", "status": "active", "state": "available", "merchantScope": "listed", "approvedAmount": "40.00", "currency": "USD" }
{
"error": { "code": "MANDATE_INVALID_TRANSITION", "message": "The mandate's current status forbids this action" }
}
Authorizations
Your secret key: sk_test_* (sandbox) or sk_live_* (production).
Path Parameters
The mandate id.
Response
Updated mandate.
A standing spending authorization (list view).
Mandate id (mdt_…).
Display-derived usability.
Available options:
available, consumed, expired, paused, cancelled, pending Available options:
pending, active, paused, consumed, cancelled, expired Available options:
one_time, weekly, monthly, yearly Available options:
any, listed The authorized per-charge cap.
Remaining spend in the current window (indicative; the network enforces the real cap).
Next cycle boundary for recurring mandates.
Show child attributes
Show child attributes