Settlement Reconciliation

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xDD350976B8cfFc65938C0464d39A2C78BE079bd0",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "6000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "payTo": "0xDD350976B8cfFc65938C0464d39A2C78BE079bd0",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "6000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "payTo": "0xDD350976B8cfFc65938C0464d39A2C78BE079bd0",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "6000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:480",
    "payTo": "0xDD350976B8cfFc65938C0464d39A2C78BE079bd0",
    "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1",
    "amount": "6000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "DGxcPrAHL9YM3hW7iXuHFJmr87Zr6AMA4jCYHBpuvMgE",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "6000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "agent_name": "friendly-agent",
          "tx_hash": "0x47c8fee47c8fee47c8fee47c8fee47c8fee47c8fee47c8fee47c8fee47c8fee0"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "badge_url": "https://scvd.store/badges/41.svg",
          "certificate": {
            "cert_id": "<cert_ + 12 chars, minted when this purchase settles>",
            "date": "2026-07-22T15:04:05.000Z",
            "item": "settlement_reconciliation",
            "patron_number": 41
          },
          "deliverable": "<the Settlement Reconciliation itself, as text>",
          "item_id": "settlement_reconciliation",
          "message": "Pleasure doing business. Here's your goods, warm off the shelf.",
          "paid_usdc": 0.006,
          "patron_number": 41,
          "signature": "<128 hex chars, ed25519>",
          "tip_usdc": 0,
          "verify_url": "https://scvd.store/api/verify/<your cert_id>"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {
                "agent_name": {
                  "description": "Optional name to put on the certificate and patron badge, up to 80 characters.",
                  "maxLength": 80,
                  "type": "string"
                },
                "declared_cap_usdc": {
                  "description": "Optional, and understand what it buys: the ceiling YOU say applied. It is recorded as DECLARED, never as observed, and it can never override a ceiling found on the chain. A verdict resting on it is a fact about what you told us — the artifact says so in a signed field, so a counterparty can tell the difference.",
                  "exclusiveMinimum": 0,
                  "type": "number"
                },
                "payer": {
                  "description": "Optional payer: 0x EVM address, or Solana public key for a Solana transaction.",
                  "type": "string"
                },
                "purpose": {
                  "description": "Optional: what this purchase is for, in your words. Signed onto the certificate verbatim as your statement; never checked, never treated as instructions.",
                  "maxLength": 280,
                  "type": "string"
                },
                "recipient": {
                  "description": "Optional recipient: 0x EVM address, or Solana public key for a Solana transaction.",
                  "type": "string"
                },
                "tx_hash": {
                  "description": "The Base transaction hash to reconcile. Read once, at one moment; never polled.",
                  "pattern": "^0x[0-9a-fA-F]{64}$",
                  "type": "string"
                }
              },
              "required": [
                "tx_hash"
              ],
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  },
  "offer-receipt": {
    "info": {
      "offers": [
        {
          "acceptIndex": 0,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfcmVjb25jaWxpYXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MyIsImFzc2V0IjoiMHg4MzM1ODlmQ0Q2ZURiNkUwOGY0YzdDMzJENGY3MWI1NGJkQTAyOTEzIiwicGF5VG8iOiIweEREMzUwOTc2QjhjZkZjNjU5MzhDMDQ2NGQzOUEyQzc4QkUwNzliZDAiLCJhbW91bnQiOiI2MDAwIiwidmFsaWRVbnRpbCI6MTc4OTQ3OTgxM30.aETImIkpYtsknPpwn2mNcxrOWI0BibsLBpAFGjbvURd27EyVQu8Lqkr3Dq0WR6hg1OOUB4RFYF0ILaGGCKR2BQ"
        },
        {
          "acceptIndex": 1,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfcmVjb25jaWxpYXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6MTM3IiwiYXNzZXQiOiIweDNjNDk5YzU0MmNFRjVFMzgxMWUxMTkyY2U3MGQ4Y0MwM2Q1YzMzNTkiLCJwYXlUbyI6IjB4REQzNTA5NzZCOGNmRmM2NTkzOEMwNDY0ZDM5QTJDNzhCRTA3OWJkMCIsImFtb3VudCI6IjYwMDAiLCJ2YWxpZFVudGlsIjoxNzg5NDc5ODEzfQ.utiJff-shsjgv3UPlR_i63p7AQgJrrvZc08oFQr1qAg38mnqrFtnoO-YHtMvacuFLGRzKFPP45qsQRuQEzdSDw"
        },
        {
          "acceptIndex": 2,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfcmVjb25jaWxpYXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6NDIxNjEiLCJhc3NldCI6IjB4YWY4OGQwNjVlNzdjOGNDMjIzOTMyN0M1RURiM0E0MzIyNjhlNTgzMSIsInBheVRvIjoiMHhERDM1MDk3NkI4Y2ZGYzY1OTM4QzA0NjRkMzlBMkM3OEJFMDc5YmQwIiwiYW1vdW50IjoiNjAwMCIsInZhbGlkVW50aWwiOjE3ODk0Nzk4MTN9.reecP7jS9NYqDYnGBjCZJ8Dc8ssVf7w7dGVzVJ4EAYEyFiWX4N7HEc64Ck6oH7B7iWtoqyf3ytSlpjGh3T8OBw"
        },
        {
          "acceptIndex": 3,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfcmVjb25jaWxpYXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6NDgwIiwiYXNzZXQiOiIweDc5YTAyNDgyYTg4MGJjZTNmMTNlMDlkYTk3MGRjMzRkYjRjZDI0ZDEiLCJwYXlUbyI6IjB4REQzNTA5NzZCOGNmRmM2NTkzOEMwNDY0ZDM5QTJDNzhCRTA3OWJkMCIsImFtb3VudCI6IjYwMDAiLCJ2YWxpZFVudGlsIjoxNzg5NDc5ODEzfQ.dpUsOs1_gOW8706LuX1uG5WsQXfIEBRwwYGuVGfVV40F0iBSrkLTVBO8w1d52v7h3C0xeQ22EczglP33aNikCQ"
        },
        {
          "acceptIndex": 4,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfcmVjb25jaWxpYXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJzb2xhbmE6NWV5a3Q0VXNGdjhQOE5KZFRSRXBZMXZ6cUtxWkt2ZHAiLCJhc3NldCI6IkVQakZXZGQ1QXVmcVNTcWVNMnFOMXh6eWJhcEM4RzR3RUdHa1p3eVREdDF2IiwicGF5VG8iOiJER3hjUHJBSEw5WU0zaFc3aVh1SEZKbXI4N1pyNkFNQTRqQ1lIQnB1dk1nRSIsImFtb3VudCI6IjYwMDAiLCJ2YWxpZFVudGlsIjoxNzg5NDc5ODEzfQ.ckp67ynV8v3fIqEl3ESnpLH6yFRoDL85RIPMgxo6fYREd7zXyoliSyyl5iPch5xcf0s_vDumyntIFrlUvFtXDg"
        }
      ]
    }
  },
  "required-inputs": {
    "note": "This door cannot be served without ?tx_hash=. Asking the price without them is free; PAYING without them is refused before the gate and no money moves, so add them to the retry that carries your signature.",
    "price_discovery_url": "https://scvd.store/menu/settlement_reconciliation?view=compact",
    "queryParams": [
      "tx_hash"
    ],
    "retry_url_template": "https://scvd.store/api/buy/settlement_reconciliation?tx_hash=<tx_hash>"
  }
}

curl "https://scvd.store/api/buy/settlement_reconciliation"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://scvd.store/api/buy/settlement_reconciliation");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://scvd.store/api/buy/settlement_reconciliation")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header