verify_payment
Verify an on-chain payment without trusting any RPC: did this tx transfer at least this amount of a token (default USDC) to this payee, optionally from this payer? Proven by Plumb (Base via proof-backed L1 checkpoints, Ethereum via a light client, XRP Ledger via a quorum of Ripple's validator list: RLUSD, XRP or any issued currency). Bound to the exact transfer (log index); returns the proof level, how long a Base checkpoint can still be challenged, the evidence to re-check, and an Ed25519-signed receipt. Never answers not_paid while a payment is still pending; abstains (unverifiable) whenever the proof is incomplete. Costs $0.02 USDC (x402) ($0.002 for an XRP Ledger payment); asking again about the same claim costs nothing. Optional requiredLevel (releasable or not) and callbackUrl (signed events when the level is reached, the answer changes, or checking gives up).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain of the payment | base |
| payee | Yes | Address that should have received the money (XRPL: an r... account) | |
| payer | No | Only count transfers from this address (the token holder who paid) | |
| token | No | ERC-20 contract (default: USDC on the chain). XRPL: RLUSD (default), XRP, or CURRENCY.rIssuer | |
| txHash | Yes | Transaction hash (0x + 64 hex; XRPL: 64 hex) | |
| logIndex | No | Bind to one transfer: its position within the tx's logs | |
| invoiceId | No | XRPL only: the InvoiceID (64 hex) the payment must carry; binds the answer and its signed receipt to your invoice | |
| callbackUrl | No | https URL to notify (signed, retried) when requiredLevel is reached, when the answer changes, or when checking gives up | |
| minAmountRaw | No | Minimum amount in base units, e.g. "50000" = 0.05 USDC (default: any). XRPL: XRP drops, or millionths of an issued currency | |
| requiredLevel | No | Proof level you need before releasing money (Base: tee_attested < zk_proven < resolved; Ethereum: finalized; XRPL: unl_quorum). The answer then says whether it is releasable. |