New features​

🫰🏽 As part of our Accept Payments feature, merchants can add a logo to their merchant profile using the addMerchantProfile mutation. An existing merchant profile can be updated using the requestMerchantProfileUpdate mutation.

Improvements​

🍂 When a SEPA Credit Transfer is initiated using mode=InstantWithFallback and the transfer is rejected by the beneficiary bank, a fallback will always be triggered except when the recipient account is unknown, closed, or the account holder is deceased.

⛔ As part of our Accept Payments feature, we deleted a few API mutations and fields that were previously flagged as deprecated. Please note that the deprecated mutations and fields are no longer accessible or supported in any capacity following this release. Learn more about Accepting Payments

• MerchantPaymentProduct becomes MerchantPaymentMethod.
• requestMerchantPaymentProducts becomes requestMerchantPaymentMethods.
• requestMerchantPaymentProductsInput becomes requestMerchantPaymentMethodsInput.
• InternalDirectDebit is now divided into two different mutations: InternalDirectDebitStandard & InternalDirectDebitB2B. As a result, InternalDirectDebitStandardPaymentMethodInput & InternalDirectDebitB2BPaymentMethodInput are new input names to request such payment methods.
• CheckMerchantPaymentProduct becomes CheckMerchantPaymentMethod.
• CheckPaymentProductInput becomes CheckPaymentMethodInput.

🧾 Limited accounts can no longer initiate credit transfers.

🙅🏻‍♀️ We added a new enum value to accountHolder.verificationStatus: Refused.

Upcoming breaking changes​

🌍 As part of our future International Credit Transfers offer, new values will be added to the TransactionType enum: InternationalCreditTransferIn, InternationalCreditTransferOut, InternationalCreditTransferInReturn, and InternationalCreditTransferOutReturn.

🌍 As part of our future International Credit Transfers offer, a new value will be added to the PaymentProduct enum: InternationalCreditTransfer.

New features​

🤳🏻 To improve text message deliverability, receive text messages from AUTHLINK instead of AUTHMSG when consenting to sensitive operations.

Improvements​

📱 Consent or log in with a QR code if there's an issue receiving the text message.

😃 Run consents and user queries with a project access token.

🔄 On your Dashboard > Data tab, check out the Transactions page to view all transactions for your project.

⚠️ We are starting to use the new enum values for FeesType that were added to the API three weeks ago.

New features​

🇪🇸 Instant SEPA Credit Transfers for Spanish account are live. Learn more about requirements for individual and company Spanish accounts.

🦢 Swan's design system, Swan Lake, is public! A natural complement to Swan's open source frontend, Lake gives you a head start with a collection of building blocks for an accessible banking UX/UI.

Improvements​

🛒 Manage your merchant profiles from the Dashboard > Data > Accounts page.

📃 Generate a PDF version of SEPA Direct Debit payment mandates. Merchant customers might need to send this PDF to their banks.

📄 Generate custom account statements with your designated 3-month date range directly from the Web Banking > History page.

📈 To increase the identity verification conversion rate, when the identification fails, we now include a re-engagement link in the text message sent to the user.

👀 We added an unmasked IBAN field for both the debtor and creditor when querying SEPACreditTransferTransaction and SEPADirectDebitTransaction. You can choose how much information to expose when using these queries.

😃 Call the transaction query with a user access token; a project access token is no longer required.

Upcoming breaking changes​

⚠️ In three weeks, we'll start using new enum values for FeesType that have been added to the API. To avoid breaking changes on your side, please take these into account.

New features​

↪ When using the Accept Payments feature, merchants can get paid by SEPA Direct Debit with both B2B and Core methods. The feature is only in Sandbox right now; please let us know if you're interested in beta testing!

🔍 There is a new transactions query to make searching transactions easier.

Improvements​

📑 During the KYC process, you can upload supporting documents Swan requires from your end customers, and request a review. Contact us to activate this feature and receive fewer reminder emails from Swan.

✅ With Internal Direct Debit B2B, use the addReceivedInternalDirectDebitB2bMandate mutation to receive the debtor's consent when declaring a payment mandate.

📣 Sometimes, the KYC process is delayed because of website outages for European business registries. Subscribe to the Swan status page to learn about these delays. There is a new section called Onboarding - European Business Registries where we will post a live incident about who is affected and the overall level of impact.

New features​

🪪 Swan takes another step forward to increase the conversion rate to onboard individual French accounts. PVID (Prestataire Verification d'Identité à Distance) is the latest French identity verification process that provides a fast, secure way to onboard end-customers, with a better user experience. Thanks to PVID, the first transfer or electronic signature is no longer required for EU users opening accounts with French IBANs.

Improvements​

🇪🇺 Every word in every language for Web Banking, Onboarding, text messages, and more (almost 7000 words in 6 languages), was reviewed by our new localization team. We hope your experience in the supported language of your choice improves significantly, and please continue sharing your language-specific feedback with us.

📈 We improved webhook performance and resiliency thanks to a full refactoring.

Breaking changes​

📱 We'll no longer send a text message to users when their identity is successfully verified. Why? With the User webhooks, you can track their progress and notify them however you choose.

New features​

🇪🇸 IBANs starting with ES are live! SEPA Instant Credit Transfers for Spanish IBANs are still in the making and will be live in 2 weeks. You can test both Spanish IBANs and SEPA Instant Credit Transfers with Spanish IBANs with the API or on your Dashboard > Settings > Onboarding.

For each country, Swan must comply with different requirements depending on local law. Learn more about requirements for individual and company Spanish accounts.

Improvements​

💲 When a transaction is processed in a currency other than euros €, this currency with the converted amount is now displayed on your Dashboard.

🔎 On the Dashboard Accounts page, we added a "fees" option to the payment product filter.

⚡ When an instant transfer is requested but can't be processed for any reason, we automatically execute a regular transfer instead. In the transaction history, users will see the method "transfer" instead of "instant transfer", and there will be an alert in the transaction details. This is only for Swan Web Banking.

⏲️ The Time-To-Live (TTL, auto-disconnection) from both our Dashboard and Web Banking platforms have been reduced.

• Dashboard: reduced to 72 hours; the session will refresh every time an API call is sent.
• Web Banking: reduced to 5 minutes; the session token will refresh as long as the Web Banking page stays open.

📱 We improved mobile navigation for Web Banking for a smoother user experience.

New features​

👩🏽‍💻 Subscribe to our new User webhooks to receive real-time updates on any changes related to your users. You can track the identity verification (identifications) process and more. You can also get the list of users who have connected to your project with the new API users query.

🤖 Impersonate a user with a project access token to unlock certain use cases.

💼 We're ready to onboard our first Partners to collect French checks. Please contact us if you're interested in beta testing!

Improvements​

🔍 A new filter period was added to the account statements collection. Use it to filter account statements, whether you create them when you need them or you generate them automatically.

🇪🇺 On your PDF account statements, amounts are now displayed in the local format based on the account language. We'll continue to improve the localized experience.

👑 The project owner's legal representative can now see their card numbers with the API. Also, in Sandbox, promote any account holder in the project to project owner with the testing API mutation promoteAccountHolderToProjectOwner.

Bug fix​

🇫🇷 From May 12th to May 15th, Bouygues Telecom blocked text message delivery to French phone numbers (+33), messages that included a link to authenticate. As a quick fix, we will temporarily send https://link.swan.io instead of https://authmsg.co.

💳 In the Card.Updated webhook, eventDate changed to updatedAt (previously createdAt).

Breaking changes​

⏲️ To improve our webhook performance, we added a timeout of 15 seconds to endpoint requests. When there is no response after 15 seconds, the webhook fails and will automatically retry.

💥 In the addCards mutation, the input field additionalEmbossedLine is now additionalPrintedLine for consistency and user clarity.

Upcoming breaking changes​

📱 In 4 weeks, Swan will stop sending a text message to users when their identity is successfully verified. Why? With the new User webhook, you can track their progress and notify them however you choose!

New features​

🎉 Customize your Web Banking app and onboarding process starting from Swan's open source Banking Frontend. Consider this a reference implementation: you can learn from it, then copy and modify it to fit your needs!

Improvements​

⚡ Instant SEPA Credit Transfer fallback can be tested using the Testing API. Initiate an outgoing Instant SEPA Credit Transfer, then reject it using simulateOutgoingSepaCreditTransferRejection mutation. Use reasonCode: BeneficiaryBankNotReachable.

🫢 Upcoming outgoing Instant SEPA Credit Transfer can be canceled using the cancelTransaction mutation.

✍️ The externalReference field in initiateCreditTransfers is now working for outgoing Instant SEPA Credit Transfer.

🆔 We added the accountId field to Invoice. Use it to find the account associated to an AccountInvoice.Generated webhook event.

Bug fix​

📄 Fee amount are displayed in the .csv account statement

Upcoming breaking changes​

👮‍♀️ To avoid undesired behaviors with our API, we are changing the Tax Identification Number (TIN) accepted format in all the taxIdentificationNumber inputs from 1-11 characters to 7-11 characters in 4 weeks.

💥 isInstant field for initiateCreditTransfer is depreciated and will be removed in 6 months. Please use mode field instead to initiate an Instant SEPA Credit Transfer.

DOCS:

💶 Learn how to build a compliant billing offer.