August 2026
As of August 26, 2026, filtering Gateway x402 transfers by
status requires a
narrowing filter. Supply at least one of from, to, or nonce in the same
request. This is a breaking change for callers that filter by status alone, or
that combine it only with network, token, or a date range: those requests
return 400.Searching every transfer in a given status isn’t supported because the query
takes longer than the request timeout allows. To find the transfers for one
account, filter by from or to. To look up a single transfer you already have
an identifier for, filter by nonce or use
GET /v1/x402/transfers/{id}.API updates
The following endpoint was updated on August 26, 2026:GET /v1/x402/transfers: thestatusquery parameter requiresfrom,to, ornonce.
New features
Added ERC-1271 support to Gateway. Smart contracts and smart contract accounts (SCAs) can now authorize burn intents directly with their own signature validation logic, so multisigs, passkey-based accounts, and policy-driven contracts can access a unified USDC balance without adding a delegate.Documentation additions
July 2026
Added
nonce support to the Gateway x402 transfer APIs. You can now filter
transfers by nonce, and transfer responses include the nonce field along with
a nullable txHash field.API updates
The following endpoints were updated:GET /v1/x402/transfers—added optionalnoncequery parameter.GET /v1/x402/transfers/{id}—response now includesnonceandtxHash.
May 2026
Updated the Gateway unified balance Solana quickstart to simplify the
script-based flow and add Direct Mint and Forwarding Service branches.
Documentation updates
The following documentation was updated:Updated the Gateway unified balance EVM quickstart to simplify the script-based
flow and add Forwarding Service coverage.
Documentation updates
The following documentation was updated:Added Gateway webhook documentation and subscription management API references.
Documentation additions
The following documentation was created:API additions
Added the following endpoints to support Gateway webhook subscriptions:POST /v2/notifications/subscriptions/permissionlessGET /v2/notifications/subscriptions/permissionlessGET /v2/notifications/subscriptions/permissionless/{id}PUT /v2/notifications/subscriptions/permissionless/{id}DELETE /v2/notifications/subscriptions/permissionless/{id}POST /v2/notifications/subscriptions/permissionless/{id}/testPOST /v2/notifications/subscriptions/permissionless/{id}/test-notificationGET /v2/notifications/signatures/{notificationId}
April 2026
Updated nanopayments documentation to reflect mainnet launch support.
Documentation updates
The following documentation was updated:Expanded the nanopayments documentation with additional buyer, seller,
facilitator, and x402 integration guidance.
Documentation updates
The following documentation was updated:- Quickstart: Pay for resources with nanopayments
- Quickstart: Accept payments with nanopayments
- How-to: Integrate nanopayments into your existing facilitator
- How-to: Add nanopayments to an x402 buyer
- How-to: Add nanopayments to an x402 seller
- How-to: Use nanopayments with x402
- How-to: Sign EIP-3009 payment authorizations
Updated Gateway on Solana documentation to support transfers with the Forwarding
Service and automatic ATA creation.
Documentation updates
The following documentation was updated:March 2026
Updated the Gateway unified balance quickstarts to support both Circle Wallets
and permissionless implementations on the same page.
Documentation updates
The following documentation was updated:February 2026
Added Forwarding Service support for Gateway. The following new topic was
created:
Added support for managing delegates for Smart Contract Account (SCA) wallets.
Documentation additions
The following documentation was created:Updated Gateway quickstart guides and how-tos to use consistent script structure
and console output patterns.
Documentation updates
The following documentation were updated:January 2026
Added support for Gateway on Solana. The following new topics were created: