August 2026
Beginning August 17, 2026, filtering Gateway x402 transfers by
status will
require 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 will return 400 beginning on that date.Searching every transfer in a given status will no longer be 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 will change on August 17, 2026:GET /v1/x402/transfers: thestatusquery parameter will requirefrom,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}
Added a new quickstart for making gasless Gateway deposits with Eco.
Documentation additions
The following documentation was created: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: