Skip to main content

ยท One min read

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.

ยท One min read

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.

ยท One min read

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.

ยท One min read

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.

ยท One min read

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.

ยท 2 min read

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.

ยท One min read

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.

ยท One min read

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.

ยท One min read

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.

ยท 2 min read

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.