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 5, we're doing a database migration of our webhooks. Only logs from January 1 on will be migrated, meaning all data from 2023 and before will be lost. From February 5 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.

New features​

🇳🇱 Dutch IBANs starting with NL are live! You can test Dutch IBANs with the API or on your Dashboard > Settings > Onboarding.

💡 For each country, Swan must comply with different requirements depending on local laws. Learn more about requirements for individual and company accounts in the Netherlands.

Improvements​

ℹ️ We added a reason to the ReleasedTransactionStatusInfo query. You can now see why a card authorization was released. Possible values: Captured, Expired, AdviceReceived, MerchantReleased, ManuallyReleased, and Other.

📅 You can now schedule an Internal Direct Debit transaction. In the initiateMerchantPaymentCollection mutation, use the requestedExecutionAt field.

❌ The cancelTransaction mutation now supports canceling incoming Internal Direct Debit transactions with the status Upcoming.

Breaking changes​

💥 There are two key changes to the addInternalDirectDebitPaymentMandate mutation: (1) We removed the scheme and merchantProfileId fields. Use paymentMethodId instead. (2) The InternalDirectDebitPaymentMandateId is no longer returned in the success payload.

Upcoming breaking changes​

⚠️ The isInstant field for initiateCreditTransfers is deprecated and will be removed in 7 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.

🔍 In the users query, search moved to the filters category and requires at least 3 characters. The old search will be deprecated in 4 weeks.

Improvements​

🔄 When providing consent, users can now request a new text message if the original text message wasn't received.

📃 We added the account object in accountStatement. Use it to link an account to its generated account statements.

🔍 The transactions query can now be filtered by transactionId.

Breaking changes​

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