Managing accounts

Before you can create cards, you need to get your bank account details.

This page will explain how to manage accounts by API and has the following sections:

• Creating a new account
• Getting account details

Creating a new account

This is how you to create a new bank account:

curl {baseURL}/yordexpay  
-H "Authorization:your-api-key"  
-X POST
-d '{
  "currency": "GBP",
  "provider": "RAILSBANK",
  "name" : "London Office"
}'

All fields are mandatory.

Getting account details

This is how you get your bank accounts details:

curl {baseURL}/yordexpay  
-H "Authorization:your-api-key"  
-X GET

This response will look like this

{
  "status": "ACTIVATED",
  "accounts": [
    {
      "id": "yordex-pay-account-id",
      "provider": "RAILSBANK",
      "name": "London Office",
      "balanceInCents": 500000,
      "currency": "GBP",
      "status": "ACTIVATED",
      "bankAccount": {
        "accountHolderName": "Yordex",
        "accountNumber": "12345678",
        "sortCode": "000000",
        "iban": "GB16PAYR00000000",
        "bic": "PAYRGB2LXXX"
      }
      ... // other fields
    }
  ]
}

accounts is an array as you can have multiple bank accounts.

The id is required to create cards. The provider is our banking partner. We offer two providers today: Railsbank and Stripe. The name is a name you can give to make it easier to distinguish accounts if you have more than one.

The balanceInCents is the balance left on this account and the bankAccount are the account details for this account. Other fields are returned but they are not important yet at this point.