🇩🇪 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.
💳 Account members can request their own cards with the new account membership permission canManageCards.
🪝 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.
⚡ 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.
🚨 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.
📊 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.
🇳🇱 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.
ℹ️ 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.
💥 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.
⚠️ 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.
🔄 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.
⚠️ In 4 weeks, we're adding the new value GeneralAssemblyMinutes to the SupportingDocumentPurpose enum.
💳 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.
🤩 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.
💸 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.
⚠️ 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.
🫰🏽 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.
🍂 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.
🌍 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.
🤳🏻 To improve text message deliverability, receive text messages from AUTHLINK instead of AUTHMSG when consenting to sensitive operations.
📱 Consent or log in with a QR code if there's an issue receiving the text message.
😃 Run consents and user queries with a project access token.
🔄 On your Dashboard > Data tab, check out the Transactions page to view all transactions for your project.
⚠️ We are starting to use the new enum values for FeesType that were added to the API three weeks ago.