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.

Improvements​

💳 We've added new fields to Payment Control messages:

• terminalId: The payment terminal that was used to initiate the transaction.
• mechantPostalCode: The postal code of the merchant that initiated the transaction (this field will start being populated in October 2023, note that not all merchants communicate this information).
• digitalCardWalletProvider: The digital token used for the transaction (when applicable), possible values are: ApplePay, GooglePay, Merchant.

🧪 The simulateIncomingInternalDirectDebitReturn mutation allows to simulate a return on an Internal Direct Debit transaction.

New features​

🤩 We redesigned the Data tab on the Dashboard to be more customer centric. View a list of unique users connected to your project with a 360 view of their accounts and cards. These improvements should help your operations and customer support teams.

Improvements​

💸 We redesigned the Web Banking transfer page following your feedback. It's ready to welcome the upcoming International Credit Transfer feature.

🪶 We added two new fields at the transaction level: reservedAmount and reservedAmountReleasedAt. Keep an eye on these fields to improve the user experience with account funding and accepting payments, and soon in Web Banking and Dashboard.

Upcoming breaking changes​

⚠️ The scheme and merchantProfileId inputs are deprecated and will be removed from the addInternalDirectDebitPaymentMandate API mutation in 6 weeks. These inputs were redundant with the paymentMethodId input.

⚠️ In the addInternalDirectDebitPaymentMandate mutation's AddInternalDirectDebitPaymentMandateSuccessPayload, the InternalDirectDebitPaymentMandateId field will no longer be returned starting 12 weeks from now. Please use the id available in the paymentMandate object instead.