Skip to content

Шаг 3. Получение списка банков для клиента

На этом шаге выполняется получение списка доступных банков по указанной валюте для выбора клиентом банка получателя.

В качестве параметра запроса передается валюта (ID или символ валюты), для которой нужно получить банки.

Запрос:

curl -X GET https://api.creon.ae/v2/banks?currency=KZT \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{"currency":"KZT"}'

Описание полей:

  • currency: string (required) - ID или символ валюты (ISO код), пример: KZT

Разбор ответа:

  • Status 200: 

    {
  "banks": [
    {
      "id": "e7de10cf-c773-4007-b288-842db239a26b",
      "name": "Kaspi",
      "country_code": "KZ"
    }
  ]
}

    • banks (array): Список доступных банков
      • id (string, uuid): Уникальный ID банка, используется для дальнейших операций;
      • name (string): Название банка;
      • country_code (string, optional): Код страны банка (ISO 3166-1 alpha-2);

  • Status 400: Authentication failed. Access token is invalid. 

    {
  "error": "ERROR_ACCESS_TOKEN_INVALID", 
  "message": "Access token is invalid.", 
  "statusCode": 400 
}

    • error: string (required)
    • message: string (required)
    • statusCode: number

  • Status 401: Authentication required 

    {
  "error": "ERROR_AUTHENTICATION_REQUIRED", 
  "message": "This method can only be accessed with authentication", 
  "statusCode": 401 
}

    • error: string (required)
    • message: string (required)
    • statusCode: number

  • Status 401: Authentication failed. Access token has expired. 

    {
  "error": "ERROR_TOKEN_EXPIRED", 
  "message": "Access token has expired", 
  "statusCode": 401 
}

    • error: string (required)
    • message: string (required)
    • statusCode: number