New features​

🏦 Swan is now available for Open Banking aggregators. They can connect to our API to access the account and transactions. If you are interested in this, contact us!

Improvements​

📄 Validate a capital deposit case and change the status of capital deposit documents with the Event Simulator or the Testing API.

Upcoming breaking changes​

⚠️ In 4 weeks, queries using pagination will be limited to 100 elements to load per request.

💥 For API consistency, we deprecated the value Recurring for InternalDirectDebitSequence and DirectDebitSequence. Please use Recurrent instead in the mutations addInternalDirectDebitPaymentMandate and addSepaDirectDebitPaymentMandate.

New features​

🌍 In February, Swan IBANs will be able to receive incoming SWIFT transfers. To help you prepare for this new feature, you can test the reception of an incoming International Credit Transfer using our Testing API simulateIncomingInternationalCreditTransferReception or Event Simulator.

Improvements​

💳 Card option and spending limit values are displayed in the consent screen language instead of English by default.

🆔 To simulate different stages of the identification process for Sandbox users, you can now use the Event Simulator or the Testing API with the createSandboxIdentification and updateSandboxIdentification mutations. Additionally, we deprecated the identificationStatus and identificationLevels fields when creating and updating Sandbox users from the Dashboard.

New features​

🇪🇸 Swan's new Physical Card Issuing Hub in Spain is now live. Physical card shipment to Spanish end-customers now takes less time! Please contact your account manager if you're interested.

Improvements​

📄 We've added accountHolder and onboarding in the supportingDocumentCollection query to allow you to stop collecting documents via e-mail. It's more integrated and efficient, making follow-up easier. You also get better visibility on document collection throughout the onboarding process (status, content …).

Breaking changes​

⚠️ We've added new values to the SupportingDocumentPurpose enum: LegalRepresentativeProofOfIdentity, UltimateBeneficialOwnerProofOfIdentity, NIFAccreditationCard, PresidentDecisionOfAppointment, AdministratorDecisionOfAppointment, and FinancialStatements. We're also deprecating ProofOfIdentity.

New features​

🇫🇮 Our end-user interfaces are now available in Finnish.

Improvements​

🤳🏾 To improve the user experience for some payment control use cases, the card spending limits are no longer displayed on the consent screen for the mutations addCardsWithGroupDelivery, addCards, and updateCard (exception: single-use virtual cards).

⚡ Instant transfers are activated by default when initiating SEPA Credit Transfers with Swan's Web Banking interface. They fallback to regular transfers when instant isn't available.

🚓 To fight efficiently against money laundering, we implemented a new card ATM withdrawal spending limit. These limits are enforced at the account holder level and can only be modified by Swan. Review the limits

💼 We added the object relatedCapitalDepositCase to the shareholder query in order to provide details about the capital deposit case for any shareholder.

🪝 We added a new webhook, CapitalDepositDocument.Created, for when a new a document for a case or a shareholder is created. List of webhooks

‼️ Reminder: the date for addSepaDirectDebitPaymentMandate must match the format YYYY-MM-DD. Otherwise, we'll return a ValidationRejection.

Upcoming breaking changes​

⚠️ On February 5th, we're doing a database migration of our webhooks. Only logs from January 1st on will be migrated, meaning all data from 2023 and before will be lost. From February 5th on, webhook history will only be kept for 100 days. This change won't impact the subscriptions.

New features​

👤 Access identity verification details for you, either with the API or on your Dashboard > Data > Users. See their identification history, the identification levels they've validated, and why an identification attempt might have been rejected. Because of this new feature, we're deprecating user.identificationStatus.

🆔 Swan offers a document-sharing feature, providing access to identity verification document metadata as well as the documents themselves. Please submit a ticket through your Dashboard to learn more about this feature.

Improvements​

🆔 Depending on your project's configuration, the notification informing account holders that their account is open will now also be triggered in Sandbox.

🪝 Receive webhooks when a capital deposit document is updated. Using the new capitalDepositDocument query, retrieve its new status and, when rejected, the reasonCode with reason for the rejection. List of webhooks

Upcoming breaking changes​

⚠️ In 4 weeks, we're adding a new value to the SupportingDocumentPurpose enum: UltimateBeneficialOwnerProofOfAddress.

New features​

💸 Customize banking fees for your end users.

Improvements​

🏦 Access a PDF with your bank details (RIB in France) through the API, Dashboard, or Web Banking. This PDF contains all the information required to transfer funds to a Swan account.

⚡ To accelerate the capital deposit process, we now send the funds to the notary with a SEPA Instant Credit Transfer.

Breaking changes​

💥 The deprecated field isInstant for initiateCreditTransfers was removed. Please use mode instead to initiate SEPA Instant Credit Transfers. By using mode=InstantWithFallback, your SEPA Instant Credit Transfers will "fallback" to regular SEPA Credit Transfers if instant isn't available.

Upcoming breaking changes​

⚠️ In 4 weeks, we're adding new values to the SupportingDocumentPurpose enum: LegalRepresentativeProofOfIdentity, UltimateBeneficialOwnerProofOfIdentity, NIFAccreditationCard, PresidentDecisionOfAppointment, AdministratorDecisionOfAppointment, and FinancialStatements. We're also deprecating ProofOfIdentity.

⚠️ In 4 weeks, we'll remove the deprecated users.search filter. Please use users.filters.search instead, which operates the same but requires at least 3 characters to search.

Improvements​

🇩🇪 Get ready for better conversion rates when onboarding German individual accounts. When verifying their identity, users can submit their identity document and their qualified electronic signature (QES) at the same time. Previously, users had to wait until the document was approved before they could sign.

⚙️ Our API Explorer got a total makeover! In addition to a better user experience, it now includes a history of your requests, a custom favorite list, and manages multiple tabs.

New features​

💳 Account members can request their own cards with the new account membership permission canManageCards.

Improvements​

🪝 Two new Capital Deposit webhooks are available to track shareholder creation and updates. List of webhooks

🔍 The account.invoices query now features type to differentiate between invoice and refundNote.

💰 Simulate banking fees that are charged manually with the simulateManualBankingFee mutation.

Improvements​

⚡ Use the new mode field in the scheduleStandingOrder mutation to send standing orders as SEPA Instant Credit Transfers. You can fallback to a regular SEPA Credit Transfer if the instant transfer is rejected.

✏️ You can name your Internal Direct Debit mandates with the addInternalDirectDebitPaymentMandate mutation name field. See an example

📬 The field merchantPostalCode has been added to the card query.

🧪 The simulateOutgoingCardAuthorizationRelease testing API mutation received three new values: Expired, MerchantReleased, and ManuallyReleased. If no value is selected, Expired is assigned by default.

📄 You can now query supporting document collections by ID.

Upcoming breaking changes​

🚨 Reminder: The isInstant field for initiateCreditTransfers will be removed in 4 weeks. Please use mode instead to initiate a SEPA Instant Credit Transfer. By using mode=InstantWithFallback, your SEPA Instant Credit Transfers will "fallback" to a regular SEPA Credit Transfer if instant isn't available.

New features​

📊 Looking for information about your product's performance? Check out the new Insights tab on your Dashboard, where you'll find data dashboards providing insights into transactions, onboardings, and more.