Entering the IBANs

An IBAN must be associated with each currency supported by the Marketplace.

There are two possible ways of doing this: using the default value for single-currency Marketplace, or the detailed value. Usually, we recommend to select the second option, which is more specific than the first. In any case, do not confuse the two options.

NOTE

For each IBAN thus defined, you must download the corresponding bank account details (see chapter Step 2: Adding KYC documents (upload)).

  1. One default IBAN

    If your Marketplace supports only one currency (e.g. Euro), you can save the IBAN in an “iban” attribute of the POST query body.

    For example:

    {
        ...
        "iban": "FR1234567890000987654000",
        ...
    }

  2. One IBAN per currency

    If your Marketplace supports multiple currencies, you must specify the recipient account(s) by currency.

    An IBAN can receive several different currencies. On the other hand, it is not possible to enter the same IBAN several times, be it for different currencies or for the same currency.

    Enter the list of IBANs by currency as follows (e.g. for a Marketplace that supports Euro, Pound Sterling and the Swiss Franc):

    {
        ...
        "ibans": [
                {
                    "currencies": ["EUR", "GBP"],
                    "iban": "FRFR1234567890000987654000"
                },
                {
                    "currencies": ["CHF"],
                    "iban": "CH12345675432199"
                }
            ],
        ...

    In this example, the transfers (cashout) of orders in Euro and Pounds sterling will be transfered to the account FRFR1234567890000987654000. If the orders have been made in Swiss francs, they will be sent to the account CH12345675432199.

    NOTE

    Please note that at the time of registration, the Marketplace must support the currency in question. Otherwise, you receive an error 400Marketplace <marketplacename> does not support <currency> currency”.