July 2026
API updates
Managed Payments withdrawals now support a burn-all option that withdraws the full balance across the main wallet and all sub-accounts in a single operation.- Added a
burnAllboolean field onPOST /v1/cpn/managedPayments/accounts/{accountId}/withdrawals. Set totrueto sweep every sub-account together with the main wallet. - Withdrawal responses now include
burnAlland asubAccountSweepsarray that reports the amount and status (pending,complete,failed,skipped) for each sub-account sweep. SeeGET /v1/cpn/managedPayments/accounts/{accountId}/withdrawals/{withdrawalId}.
API updates
CPN Gateway now validates IBAN account numbers submitted by Originating Financial Institutions (OFIs). Submissions with invalid structure, incorrect check digits, unsupported country codes, or IBAN country codes that don’t match the associatedBANK_COUNTRY are rejected before routing.Review the new reference so you can validate on your side before submission:April 2026
Documentation additions
Added the following new topic for Managed Payments webhook events:API updates
Added and corrected the following Managed Payments endpoints:GET /v1/cpn/managedPayments/accounts/{accountId}/depositsGET /v1/cpn/managedPayments/accounts/{accountId}/deposits/{depositId}POST /v1/cpn/managedPayments/accounts/{accountId}/wireAccountsGET /v1/cpn/managedPayments/accounts/{accountId}/wireAccounts/{wireAccountId}/instructionsGET /v1/cpn/managedPayments/accounts/{accountId}/wireAccounts/{wireAccountId}GET /v1/cpn/managedPayments/accounts/{accountId}/wireAccountsPOST /v1/cpn/managedPayments/accounts/{accountId}/withdrawalsGET /v1/cpn/managedPayments/accounts/{accountId}/withdrawalsGET /v1/cpn/managedPayments/accounts/{accountId}/withdrawals/{withdrawalId}
API additions
Added the following Managed Payments credit endpoints:Added documentation for CPN Managed Payments. With Managed Payments, Circle
handles licensing, compliance, minting, and settlement so you can offer
stablecoin payments without building these systems yourself.
Documentation additions
Added the following topics for Managed Payments:- CPN Managed Payments Overview
- Quickstart: Receive stablecoin payins
- Quickstart: Send stablecoin payouts
- Settlement flows
- Sub-account architecture
API additions
Added the following Managed Payments endpoints:GET /v1/cpn/managedPayments/accountsPOST /v1/cpn/managedPayments/accountsGET /v1/cpn/managedPayments/accounts/{accountId}GET /v1/cpn/managedPayments/paymentIntentsPOST /v1/cpn/managedPayments/paymentIntentsGET /v1/cpn/managedPayments/paymentIntents/{paymentIntentId}POST /v1/cpn/managedPayments/paymentIntents/{paymentIntentId}/expirePOST /v1/cpn/managedPayments/paymentIntents/{paymentIntentId}/refundGET /v1/cpn/managedPayments/paymentsGET /v1/cpn/managedPayments/payments/{paymentId}POST /v1/cpn/managedPayments/accounts/{accountId}/withdrawalsGET /v1/cpn/managedPayments/accounts/{accountId}/withdrawalsGET /v1/cpn/managedPayments/accounts/{accountId}/withdrawals/{withdrawalId}GET /v1/cpn/managedPayments/accounts/{accountId}/depositsGET /v1/cpn/managedPayments/accounts/{accountId}/deposits/{depositId}POST /v1/cpn/managedPayments/accounts/{accountId}/wireAccountsGET /v1/cpn/managedPayments/accounts/{accountId}/wireAccounts/{wireAccountId}/instructionsGET /v1/cpn/managedPayments/addressBook/recipientsPOST /v1/cpn/managedPayments/addressBook/recipientsGET /v1/cpn/managedPayments/addressBook/recipients/{recipientId}PATCH /v1/cpn/managedPayments/addressBook/recipients/{recipientId}DELETE /v1/cpn/managedPayments/addressBook/recipients/{recipientId}GET /v1/cpn/managedPayments/payoutsPOST /v1/cpn/managedPayments/payoutsGET /v1/cpn/managedPayments/payouts/{payoutId}
Documentation updates for CPN Console 2.0: expanded and clarified developer
docs for Circle Payments Network (CPN), including new how-tos, navigation
updates, a refreshed landing page, webhook guidance, and quickstart
improvements.
Documentation additions
- How-to: Set up a Circle wallet for CPN payments
- How-to: Set up Circle on/off-ramps for CPN payments
- Bring your own wallet for CPN