🇪🇸 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.
💲 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.
📱 We improved mobile navigation for Web Banking for a smoother user experience.
👩🏽💻 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!
🔍 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.
🇫🇷 From May 12 to May 15, 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).
⏲️ 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.
📱 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!
🎉 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!
⚡ 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.
📄 Fee amount are displayed in the .csv account statement
👮♀️ 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.
↪️ Direct debit a Swan account within the same project. It's our first step for our new feature, Accept Payments. Please contact us if you're interested in beta testing!
💳 You can print one line of custom text, such as a company name, on your physical cards. To do so, you'll need to design a custom card with your PIM (Product Integration Manager) and include this additional line. Contact us if you're interested in designing a custom card, or adapting an existing design.
💥 To avoid undesired behaviors with our API, we changed the accepted date format for two fields in the Onboarding API:
IndividualUltimateBeneficialOwnerInput.birthDate must be a date YYYY-MM-DDIndividualUltimateBeneficialOwner.birthDate format change from dateTime to date⚡ We implemented a fallback option for Instant SEPA Credit Transfers. When an instant transfer is unavailable, whether for technical reasons or due to a manual risk assessment, the instant transfer will run as a standard transfer instead. Your customer won't need to reinitiate a transfer or consent a second time.
initiateCreditTransfer mutation, as well as the new filter includeRejectedWithFallback to the transactions query.false by default so your customers won't see the rejected instant transfer on their transaction history.📃 To reduce back and forth with our KYC team, we're asking some partners to collect additional supporting documents during onboarding for some use cases:
🇩🇪 For German account onboarding (accountCountry: DEU), three fields are now API-optional:
individualUltimateBeneficialOwners.birthDateindividualUltimateBeneficialOwners.birthCityindividualUltimateBeneficialOwners.birthCityPostalCode📼 We added a new field originTransaction to the API at the transaction level.
It contains its parent transaction (for example, the card debit for a card debit reversal).
🧪 We added Instant SEPA Credit Transfers and their associated recalls to the Event Simulator on your Dashboard.
💳 You can now approve authorizations with a partial amount.
To do so, indicate the partialAuthorizationAmountValue within your payment control response.
Note that not all authorizations can be authorized partially; to identify eligible authorizations, look for the allowsPartialAuthorization:true on the payment control notification we send you.
⚒️ We fixed some latency issues on our OAuth 2.0 server. Let us know if you still have trouble getting your access tokens.
💥 We added a new value SwornStatement in SupportingDocumentPurposeEnum.
To avoid breaking changes on your side, please take these into account.
We'll request this supporting document during onboarding for Spanish companies.
🎨 The onboarding and transfer pages have a fresh, new design. And guess what? We'll be ready to share our code and design system with you in the coming weeks.
📈 We added Capital Deposits to the Dashboard > Data section, which was the first step to removing the current Dashboard. Next, you'll be able to upload documents and simulate everything with the Event Simulator.
🇩🇪 IBANs starting with DE are live after 3 successful months in beta.
You can use them via the API or no-code, across all use cases including B2B and B2C!
To test them, use the new German onboarding link.
You'll find it in your Dashboard, on the Settings/Onboarding tab.
The German onboarding flow is a little different, in order to comply with German law.
Learn more about requirements for individual and company German accounts.
🪪 Verify the identity of individual account holders using a Qualified Electronic Signature. This new identification level is mandatory for individual German IBANs but can also be used for individual French IBANs in order to avoid the first transfer to finalize their identification process.
⚡ Our reachability on Instant SEPA Credit Transfers has been extended to TIPS in addition to EBA-RT1. We're now connected to most banks for initiating and receiving these transactions.
💥 We will begin using some changes we already warned you about, and have added them to the Graph. To avoid breaking changes on your side, please take these into account:
SepaInstantCreditTransferInRecall and SepaInstantCreditTransferOutRecall.SepaInstantCreditTransferOut transactions: CreditorBankTechnicalErrorOccurred and CreditorBankTimeout.✅ We added a new account activation tab to the Web Banking. This makes it easy for our no-code customers to finalize the account holder verification process. Just follow the steps.
✉️ Non-verified users can now use reset passcode by email.
💰 On March 1 2023, we will start charging banking fees directly on your customers' Swan accounts. This is the first phase of our billing project. Ultimately, this will enable you to choose which fees you want to charge your customers through Swan, and lead to additional revenue.
📃 You can now use the accountStatement query to return an account statement from its id.
💥 As mentioned in past release notes, the new rejection reasons for CardOut transactions are as follows: RetryWithChipAndPin, PinRequiredForFurtherTransaction, InvalidSecurityNumber, and InvalidExpirationDate.
These have been added to the Graph.
Please take them into account to avoid breaking changes on your side.