AnyGas Payments API

openapi: 3.2.0
info:
  title: Anygas Xyz Payments API
  version: 3.28.2
  contact:
    name: Robyn AnyGas
    url: https://anygas.xyz
  license:
    name: Service terms
    url: https://anygas.xyz/svc/api/terms
  x-lastUpdated: '2026-07-29'
  description: 'Operations tagged payments across 2 of this provider''s published API definitions: anygas-openapi.json, anygas-xyz-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.anygas.xyz/svc
  description: Production gateway (also https://anygas.xyz/svc)
tags:
- name: Payments
  description: 'Verifiable agent-to-agent payment requests: signed by the payee, checkable by the payer, provable on-chain once paid.'
paths:
  /api/payreq/info:
    get:
      tags:
      - Payments
      summary: What verifiable payment requests are and how the flow works
      operationId: payreqInfo
      responses:
        '200':
          description: Explanation and the five-step flow
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/payreq/prepare:
    post:
      tags:
      - Payments
      summary: Prepare a payment request for THE PAYEE to sign
      operationId: payreqPrepare
      description: Build the canonical request (payee, chain, token, amount, memo, expiry) and return the digest for the payee to sign with their own wallet. ROBYN NEVER SIGNS THESE and holds no payee keys — a request signed by Robyn would prove only that Robyn said so, which is exactly the trust this removes.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: request + digest + signing instructions
          content:
            application/json:
              schema:
                type: object
        '400':
          description: missing/invalid fields
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/payreq/verify:
    post:
      tags:
      - Payments
      summary: Verify a payment request before paying it
      operationId: payreqVerify
      description: Agents can pay each other but could not ASK each other for money verifiably. A plaintext "send 5 USDC to 0x…" over an unauthenticated channel is exactly the message that address-substitution theft preys on. This confirms the payee address, chain, token and amount were signed by whoever controls the payee address, and that the request has not expired. Rewrite the payee or the amount and the signature stops recovering. If `signedByPayee` is false, DO NOT PAY. A valid signature proves AUTHENTICITY — not that the payment is owed, and not that the payee is trustworthy. Authenticity is not authorisation.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: valid, signedByPayee, expired, recovered signer and why
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/payreq/settlement:
    post:
      tags:
      - Payments
      summary: Prove on-chain that a payment request was satisfied
      operationId: payreqSettlement
      description: 'Pass the signed request plus the `transferId` that paid it. Re-checks the transfer against the DESTINATION CHAIN and confirms the payee received at least the amount requested — so you end up with evidence both that the request was genuine and that you honoured it. `paid: null` means undetermined, which is NOT evidence of payment.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: paid true/false/null, verdict, and the full on-chain check
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
x-refined-from:
- anygas-openapi.json
- anygas-xyz-openapi.json