Zum Inhalt
HALOWERK

X402werk

settlement / verify

Reads the receipt of a transaction on Ethereum, Base, Base Sepolia, OP Mainnet, Arbitrum One, Polygon PoS or Avalanche C-Chain and compares it with what you expected to be paid. The comparison runs against the ERC-20 transfer events in the receipt, not against the transaction recipient, because in a token payment the transaction recipient is the token contract and never the seller.

POST https://x402.halowerk.com/settlement/verify

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
chainstringJaChain of the transaction, as CAIP-2 ("eip155:8453"), as a short name ("base") or as the chain id ("8453").
tx_hashstringJaHash of the settlement transaction.
expectedobjectJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "chain",
    "tx_hash",
    "expected"
  ],
  "additionalProperties": false,
  "properties": {
    "chain": {
      "type": "string",
      "enum": [
        "arb",
        "arbitrum",
        "arbitrum-one",
        "avalanche",
        "avax",
        "base",
        "base-mainnet",
        "base-sepolia",
        "basesepolia",
        "eip155:1",
        "eip155:10",
        "eip155:137",
        "eip155:42161",
        "eip155:43114",
        "eip155:8453",
        "eip155:84532",
        "eth",
        "ethereum",
        "ethereum-mainnet",
        "mainnet",
        "matic",
        "op",
        "op-mainnet",
        "optimism",
        "polygon"
      ],
      "description": "Chain of the transaction, as CAIP-2 (\"eip155:8453\"), as a short name (\"base\") or as the chain id (\"8453\")."
    },
    "tx_hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "Hash of the settlement transaction."
    },
    "expected": {
      "type": "object",
      "required": [
        "pay_to"
      ],
      "additionalProperties": false,
      "properties": {
        "pay_to": {
          "type": "string",
          "pattern": "^0x[0-9a-fA-F]{40}$",
          "description": "Address that was supposed to receive the payment — the seller, not the token contract."
        },
        "amount_units": {
          "type": "string",
          "pattern": "^[0-9]{1,78}$",
          "description": "Expected amount as an integer in the smallest unit of the token. Omit to skip the amount comparison; amount_matches is then null."
        },
        "asset": {
          "type": "string",
          "description": "Expected token contract address, or \"native\" for the chain coin. Omit to accept any token; asset_matches is then null."
        }
      }
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "chain": "arb",
  "tx_hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "expected": {
    "pay_to": "0x0000000000000000000000000000000000000000"
  }
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →