New featuresโ
๐ Your operations team can now answer more day-to-day questions on its own with our Partner Operations guides. They cover common account and payment tasks, such as verifying accounts, identifying users, managing SEPA Direct Debit mandates, and handling card disputes and chargebacks. The newest guides show how to manage account closures and troubleshoot declined card payments, including when to raise a Partner support request.
To search these guides from your own AI tools, connect them to the Swan Docs MCP server.
API updatesโ
Upcoming breaking changesโ
๐ From 14 December 2026, the account statement API will stop returning its deprecated fields, and statement generation will reject the old statementType input. If you read or generate account statements through the API, move to the replacement fields before this date. These changes apply to the accountStatement query, Account.statements, and the generateAccountStatement mutation:
feesis replaced byfeeCreditsandfeeDebits.statusis replaced by thestatusInfoobject.typeis replaced byformat.- The statement download
url, previously in thetypeobject, is only available instatusInfo. - The
statementTypeinput ofgenerateAccountStatementis replaced byformat. Requests that still sendstatementTypewill be rejected.
๐ From 31 December 2026, Swan's consent and authentication pages will stop working in iframes and popups. If your app opens these pages in an iframe or a popup, open them in the user's current browser tab instead, then use the redirect URL to bring the user back to your app. Follow the guide to integrate Strong Customer Authentication (SCA) in a web app.