Guide
API
IBAN
Definition
An IBAN identifies an account on the SEPA network (Single Euro Payment Area). This unique identifier makes it easy for banking services like Swan to make sure payments reach their destination safely - all across Europe.
An IBAN lets you receive and issue SCT (SEPA Credit Transfer) or SDD (SEPA Direct Debit).
Main Iban
When an account holder completes the verification process (Learn more) and the
paymentLevel changes to Unlimited , the account will receive an IBAN.An IBAN is made up of 34 letters and numbers, and each set of characters represents a different detail for your account.
Here is a breakdown of our IBANs:
FR76 1732 8844 00XX XXXX XXXX XYY
FR = Country Code - Swan headquarters (France)
76 = Check digits
17328 = Swan's Bank Code
84400 = Swan's Branch Code
XXXXXXXXXXX = Account number - 11 digits
YY = RIB key - 2 digits
If you feel blocked by the "FR" country code and feel it is absolutely vital to be able to distribute IBANs to your customers with a country code other than "FR", don't hesitate to get in touch: [email protected]​
Virtual IBANs
You can create multiple virtual IBANs for one Account.
An account holder can use virtual IBANs to receive SCT (SEPA Credit Transfer) or to set up SEPA Direct Debit.
Here are some of the use cases made possible with virtual IBANs:
- Paying for invoices via transfer becomes easier; providing a different virtual IBAN to each client simplifies reconciliation.
- Direct debit risk management becomes easier: you can block direct debit on certain IBANs or generate dedicated virtual IBANs for a specific supplier.
- etc.
Identifying virtual IBANs is easy: they contain a different branch code than main IBANs.
The virtual IBAN branch code: 89900
Clients make payments to individual virtual IBANs, but all the money arrives on a main account. The virtual IBANs make it easy to identify who made each payment when it shows up in your accounting.
​
To create a virtual IBAN by API you must use the
addVirtualIbanEntrymutation.Here are the different settings available for a virtual IBAN:
- Systematically reject SDDs that are addressed to it by calling the
denySddOnVirtualIbanEntrymutation - Stop systematically rejecting SDDs that are addressed to it by calling the
allowSddOnVirtualIbanEntrymutation - Temporarily reject all payments that are addressed to it by calling the
suspendVirtualIbanEntrymutation - Reactivate the possibility to receive payments that are addressed to it by calling the
resumeVirtualIbanEntrymutation - Definitively reject all payments that are addressed to it by calling the
cancelVirtualIbanEntrypayment
Last modified 4mo ago
Export as PDF
Copy link