Learn / Facilitators

x402 verify vs settle

Verify answers "would this payment work?" Settle makes it happen. Keeping them apart is what lets a seller check a payment, do the work, and only then take the money.

Verify

Verify is a read-only check: the signature recovers to the payer, the amount covers the price, the payee is right, the network and asset match, the validity window is open, the nonce is unused and the payer holds enough USDC. No transaction is sent and no gas is spent. On our facilitator the verdict takes about 650 milliseconds.

Settle

Settle submits the authorization to the chain. The USDC moves from payer to payee and a transaction hash comes back. This step costs gas and cannot be undone.

Why the order matters

If a seller settles first and then its handler crashes, the buyer has paid for nothing. AgentPay's facilitator verifies, lets the handler run, and settles only once a real response exists, so a failed delivery is never charged.

Dry runs

POST /facilitator/simulate returns the verify verdict plus every refusal reason without sending anything, and GET /facilitator/cost shows the all-in cost before signing. Both are free.

Common questions

Does verify cost anything?

No. Verify is off chain and free on our facilitator.

Can a verified payment still fail to settle?

Yes, if the payer spends the balance or the authorization expires between verify and settle. That is why our facilitator requires at least 6 seconds of remaining validity.

Is settle idempotent?

On our facilitator, yes: a nonce already spent on chain for the same resource counts as already settled, so the payer is not charged twice.

Keep reading

What is an x402 facilitator?x402 payment refusal codes and fixesHow x402 works, step by stepAll x402 guides
See what our facilitator supports
LearnDocsSettlement policyEndpoint report