Creating a Payment Destination

What is a Destination?

A Destination is a bank account that you want your customer to be able to transfer money into.

Create a new Destination

Call the Destinations endpoint in the Payments API to create a new Destination resource:


curl -X POST '' \
  --header 'Content-Type: application/json' \
  --header 'lean-app-token: YOUR_APP_TOKEN' \
  --data-raw '{
    "display_name": "Acme USD Account",
    "name": "Acme Inc",
    "bank_identifier": "LEANMB1",
    "address": "123 Fake St",
    "city": "Dubai",
    "country": "ARE",
    "account_number": "1008223921001",
    "swift_code": "EBILAEAD",
    "iban": "AE260260001008223921001"


Don't use special characters in the payment destination

Please do not enter any special characters in any field as this might cause banks to reject the beneficiary details. For the "address" field it is okay to enter the address as short as possible and without special characters (like a comma for example).


  "id": "266733cc-6f46-4e87-af7e-9bb46b99601d"
  "display_name": "Acme USD Account",
  "name": "Acme Inc.",
  "bank_identifier": "LEANMB1",
  "address": "123 Fake St.",
  "city": "Dubai",
  "country": "ARE",
  "account_number": "1008223921001",
  "swift_code": "EBILAEAD"
  "iban": "AE260260001008223921001",

You should store the ID of this Destination resource - as it will be used to determine where you route customer funds to in later stages.

Please note: Do not store any confidential, financial sensitive or PII information in the sandbox. For example, we would recommend using the dummy IBAN shown in the example above for your payment destination.

Fetch a list of all destinations

If you would like to retrieve a list of all created Destinations in your application, you can make a GET request to the Destinations endpoint: