> ## Documentation Index
> Fetch the complete documentation index at: https://docs.algovoi.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Mandate

> The verifiable authorisation behind recurring and agentic crypto payments: a payer signs a capped, revocable mandate once and every pull is checked on it.

## What it is

Crypto has **no direct debit** — no card-on-file, no network that lets you pull funds from a wallet
on a schedule. **Payment Mandate** is the missing primitive: a payer authorizes *once* — "you may
charge me **up to X per period** until **Y**" — and that authorization is **post-quantum signed**,
**offline-verifiable**, **revocable**, and **enforced on every charge** against its per-period cap.

It turns "I agreed to a subscription" into a cryptographic, machine-checkable authorization that any
platform can verify with nothing but the issuer's public key — and that an agent or billing system
checks before every recurring pull.

It is **self-contained**: bundled Falcon-1024 signing, a pluggable store (in-memory and SQLite
included), and an injected signing key. It holds no funds and moves no money — it produces and
enforces the *authorization*; your execution layer does the on-chain pull.

<CardGroup cols={2}>
  <Card title="Solves no-direct-debit" icon="repeat">
    The authorization crypto lacks. A payer signs a recurring mandate once; your platform pulls
    against it on schedule — the thing card networks give you for free and crypto doesn't.
  </Card>

  <Card title="Enforced per-period caps" icon="gauge-high">
    Every charge is checked against the mandate's cap via a store-backed, idempotent ledger — so
    "≤ 50 per month" is actually held to, with double-spend-safe accounting.
  </Card>

  <Card title="Post-quantum + offline" icon="shield-halved">
    Each mandate is Falcon-1024 signed and verifiable from the public key alone — no callback, no
    shared infrastructure. Revoke instantly with a cacheable revocation list.
  </Card>

  <Card title="Built for agents" icon="robot">
    Pairs with Agent Passport: the Passport says who the agent is; the Mandate says what the account
    holder authorized. Together: "this trusted agent may charge this account up to X."
  </Card>
</CardGroup>

## What you get

* **The recurring-authorization primitive.** A signed mandate binds a payer, a payee, a per-period
  cap, a period, an optional scope, and an expiry — the authorization a platform needs before it can
  pull a subscription or let an agent spend.

* **Enforcement, not just a claim.** Most "mandates" are a signed statement of intent. This one is
  evaluated on every pull against the per-period cap, with idempotent accounting so a retry can't
  slip a second charge through.

* **Quantum-resistant and offline-verifiable.** Falcon-1024 signing means the authorization stays
  verifiable past the migration to post-quantum cryptography, and any party verifies it with just
  the public key.

* **Instant revocation.** Withdraw a mandate the moment authority should end; it appears on a
  cacheable revocation list and fails closed thereafter.

* **One thing to integrate.** A uniform issue / verify / authorize-charge / revoke surface with a
  pluggable store, so it drops into your backend and persists where you already persist.

* **A content-addressed authority.** Each mandate exposes a stable content address derived from the
  payer, the cap, the period, and its live revocation state, the same address the
  [Spend Guardrail](/spend-guardrail) binds into a decision, so a revoked mandate addresses differently
  from the same mandate while live, and the spend authority reconciles across the whole chain.

* **Optionally Substrate 2-bound.** Fold a mandate and each authorized charge into a
  [Substrate 2](/substrate-2) receipt for a signed, audit-ready record of what was authorized and
  what was pulled.

## How it works

| Step                 | What happens                                                                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Issue**            | Bind a payer, payee, per-period cap, period, scope and expiry into a Falcon-signed mandate.                                                                         |
| **Verify**           | Anyone checks the signature, terms, expiry and revocation from the public key — offline.                                                                            |
| **Authorize charge** | Before each pull, check the amount against the per-charge and per-period caps; the ledger records it idempotently and returns the remaining headroom — or declines. |
| **Revoke**           | Withdraw the mandate instantly; further charges fail closed and it appears on the revocation list.                                                                  |

## Cryptography

* **Post-quantum signing.** The mandate is signed with Falcon-1024 (NIST Level 5) and verifies offline,
  so the authorization itself stays unforgeable after the migration to post-quantum cryptography. Each
  charge is then enforced against that signed mandate through an idempotent, per-period charge ledger.
  (For a Falcon-1024-signed receipt on every individual ALLOW/DENY decision, pair it with
  [Spend Guardrail](/spend-guardrail).)

## Why commercial

The authorization and verifier layer was never published as open source — there is no free tier to
fall back on. It is offered as a **commercial product** because the value is in a maintained,
enforced, payments-grade authorization layer:

* **Embed without attribution overhead.** A commercial OEM licence lets you ship it inside your own
  product with no open-source notice obligations to carry through distribution.
* **Enterprise terms.** Support, warranty, and a defined relationship — the terms procurement and
  risk teams expect for an authorization-critical dependency.
* **Maintained crypto suite.** Post-quantum primitives, key rotation, and revocation hosting are
  ongoing work, bundled into the licence rather than inherited.

## Who it's for

* **Crypto-subscription and stablecoin-billing platforms** that need recurring pulls but have no
  direct-debit equivalent to rely on.
* **Agentic-commerce and autonomous-procurement systems** that must authorize, cap, and revoke an
  agent's recurring spend.
* **PSPs and billing platforms** adding stablecoin rails that need a standard, enforceable
  authorization artifact across merchants and chains.
* Anyone who needs **enforceable recurring authorization** without building a post-quantum mandate
  stack themselves.

## Get Payment Mandate

Payment Mandate is an **additional, separately-licensed package** — an add-on that binds to Substrate
2, not part of Substrate 2 itself. It is available **self-serve as a Starter licence (perpetual one-time or annual)** (see below) and as a **commercial OEM SDK** — frequently paired
with [Agent Passport](/agent-passport) as an authorization stack — and is included in the AlgoVoi
Enterprise and [On-premise](/on-premise) plans. It is not distributed on public package registries.

<Card title="Buy Starter licence" icon="cart-shopping" href="https://api.algovoi.co.uk/suite-store">
  Starter licence — **perpetual (one-time) or annual subscription**, self-hosted, paid in **USDC** on mainnet; the [store](https://api.algovoi.co.uk/suite-store) shows current pricing for both and issues your licence key + install command on settlement; install from the private index and set `ALGOVOI_LICENSE_KEY` to run. Enterprise / OEM (warranty, indemnity, SLA, multi-deployment, Substrate 2 binding): [email us](mailto:hello@algovoi.co.uk).
</Card>
