Skip to content

Authorize an x402 payment using a signed mandate

Returns a signed X-Payment charged to a signed mandate — no per-payment approval. Mandates limit total budget and validity window only; host coverage is not enforced.

POST
/api/payment/x402V3Payment

Request Body​

application/json

V3 payment request.

Signed mandate to charge; its currency must match.

Payment scheme.

Valid values"exact"

base, base-sepolia (or CAIP-2), fluxa-monetize-credits, or xrpl-mainnet (where enabled).

Amount in atomic units.

Currency.

Valid values"USDC""FLUXA_MONETIZE_CREDITS""XRP"
Default"USDC"

Token contract (USDC).

Recipient (for credits: monetize.fluxapay.xyz).

Host of the resource being paid.

Full resource URL.

Shown to the user.

EIP-712 domain name (extra.name).

EIP-712 domain version (extra.version).

Signature validity; default 60, clamped to 30–300.

Minimum30
Maximum300
Default60

Responses​

Signed payment.

application/json

Signed payment.

ok.

Send as the X-Payment header when retrying the resource.

Decoded X-Payment.

FluxA payment record ID.

Signature expiry (Unix seconds).

Human-readable note.

Guidance for LLM agents. Surface instructions to the model.

{
  "status": "<string>",
  "xPaymentB64": "<string>",
  "xPayment": {
    "x402Version": "<integer>",
    "scheme": "<string>",
    "network": "<string>",
    "payload": {
      "signature": "<string>",
      "authorization": {
        "from": "<string>",
        "to": "<string>",
        "value": "<string>",
        "validAfter": "<string>",
        "validBefore": "<string>",
        "nonce": "<string>"
      }
    }
  },
  "paymentRecordId": "<integer>",
  "expiresAt": "<integer>",
  "message": "<string>",
  "payment_model_context": {
    "instructions": "<string>"
  }
}

Released under the MIT License.