Praecise Platform
Menu

Skerry/ Reference/ Limits, agents and approvals

A customer's spend policies as mandates (`object

get/mandates

A customer's spend policies as mandates (object: "mandate", same ids), each with usage: per currency family or currency, what was spent in the last 24 hours and 30 days and what remains, in integer minor units of the unit named, and how many operations were let through. ?customer_id= (required) &status=

Before you call

Credential
Authorization: Bearer $KEY
Scope
policies:read
Moves money
no
Idempotency
none
Untrusted
name, purpose, approved_by, summary, revoked_reason

Parameters

  • customer_idstringrequired
    In the query. The customer, by any of its ids.
  • statusstring
    In the query. Only objects in this state.
  • limitinteger
    In the query. How many to return, 1 to 100.
  • cursorstring
    In the query. The next_cursor of the previous page.

Responses

  • 200
    Success.
  • 202
    requires_approval — Not an error: the operation is held for a person. The body names the approval.
  • 400
    price_below_minimum — The price is below the smallest single payment for a method (detail.method, detail.minimum), or has a part of a cent. Set credit_only, raise the price, or drop the method.
  • 401
    dpop_invalid — The token is bound to a key and the DPoP proof was missing, wrong for this request, or already used.
  • 402
    payment_failed — The payer's bank or card refused. detail.reason says why in plain terms.
  • 403
    agent_payment_over_max — The merchant asks for more than max_amount. Nothing was signed. detail.asked_minor is the lowest price asked, in US cents.
  • 404
    not_found — No such object in this project — including one that belongs to somebody else.
  • 409
    token_not_issued — A delegated payment token could not be issued ready to use, for instance because the payer would have to act. Nothing was sent to the merchant.
  • 429
    too_many_waiters — This key already has as many requests waiting (?wait=) as it may. Let one finish, or read without wait.
  • 500
    internal_error — Ours. Quote the request_id and we can find the call.
  • 502
    platform_error — A provider failed. Safe to retry with the same Idempotency-Key.
  • 503
    oauth_unavailable — The authorisation server's keys could not be read, so tokens cannot be checked. API keys still work.

This page as Markdown