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.

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:

   json
   {
       ...
       "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):

   json
   {
       ...
       "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 400 “Marketplace <marketplacename> does not support <currency> currency”.