Report a settlement

Report the facilitator's settlement transaction for a completed x402 payment.

POST/v1/agent-api/intents/{intentId}/settlement-report

If you pay through catena x402, catena mpp, or the SDK's x402 and MPP fetch wrappers, you don't need to call this endpoint, since they will report the settlement for you.

Path parameters

intentIdstringRequired

Body parameters

txHashstringRequired

receiptobjectOptional

Responses

200

Settlement hint recorded. Stored as an untrusted hint only — on-chain verification remains the source of truth, and a payment with no settlement record yet still answers success.

403

Payment intent does not belong to the calling agent

404

Payment intent not found

409

Intent is not an x402 payment

Response fields

successtrueRequired

Updated October 29, 2026 Generated from the agent API's published OpenAPI document View as Markdown