> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meridian.vip/llms.txt
> Use this file to discover all available pages before exploring further.

# Список банков

> Получение списка доступных банков (payment options) для методов оплаты через Meridian API

## Получение списка банков

Endpoint для получения списка банков:

```
GET https://api.meridian.vip/api/v1/payment-options
```

***

## Пример запроса

<CodeGroup>
  ```javascript Node.js theme={null}
  const crypto = require('crypto');

  // Функция для расчета подписи
  function calculateSignature(method, url, secret) {
    const stringToSign = method + url;
    const hmac = crypto.createHmac('sha256', secret);
    hmac.update(stringToSign);
    return hmac.digest('base64');
  }

  // Запрос списка банков
  const method = 'GET';
  const url = 'https://api.meridian.vip/api/v1/payment-options';

  // Ваш API ключ
  const apiKey = 'luma_abc123...:luma_xyz789...';
  const [keyId, secret] = apiKey.split(':');
  const signature = calculateSignature(method, url, secret);

  // Отправка запроса
  const response = await fetch(url, {
    method,
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': apiKey,
      'X-Signature': signature
    }
  });

  const result = await response.json();
  console.log(result);
  ```

  ```python Python theme={null}
  import hmac
  import hashlib
  import base64
  import requests

  # Функция для расчета подписи
  def calculate_signature(method, url, secret):
      string_to_sign = method + url
      signature = hmac.new(
          secret.encode('utf-8'),
          string_to_sign.encode('utf-8'),
          hashlib.sha256
      ).digest()
      return base64.b64encode(signature).decode('utf-8')

  # Запрос списка банков
  method = 'GET'
  url = 'https://api.meridian.vip/api/v1/payment-options'

  # Ваш API ключ
  api_key = 'luma_abc123...:luma_xyz789...'
  key_id, secret = api_key.split(':')
  signature = calculate_signature(method, url, secret)

  # Отправка запроса
  response = requests.get(
      url,
      headers={
          'Content-Type': 'application/json',
          'X-API-Key': api_key,
          'X-Signature': signature
      }
  )

  result = response.json()
  print(result)
  ```

  ```php PHP theme={null}
  <?php

  function calculateSignature($method, $url, $secret) {
      $stringToSign = $method . $url;
      $signature = hash_hmac('sha256', $stringToSign, $secret, true);
      return base64_encode($signature);
  }

  // Запрос списка банков
  $method = 'GET';
  $url = 'https://api.meridian.vip/api/v1/payment-options';

  // Ваш API ключ
  $apiKey = 'luma_abc123...:luma_xyz789...';
  list($keyId, $secret) = explode(':', $apiKey);
  $signature = calculateSignature($method, $url, $secret);

  // Отправка запроса
  $ch = curl_init($url);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'Content-Type: application/json',
      'X-API-Key: ' . $apiKey,
      'X-Signature: ' . $signature
  ]);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

  $response = curl_exec($ch);
  curl_close($ch);

  $result = json_decode($response, true);
  print_r($result);
  ?>
  ```

  ```bash cURL theme={null}
  # Установите переменные
  API_KEY="luma_abc123...:luma_xyz789..."
  METHOD="GET"
  URL="https://api.meridian.vip/api/v1/payment-options"

  # Разделите ключ
  KEY_ID=$(echo $API_KEY | cut -d':' -f1)
  SECRET=$(echo $API_KEY | cut -d':' -f2)

  # Создайте подпись
  SIGNATURE=$(echo -n "${METHOD}${URL}" | openssl dgst -sha256 -hmac "$SECRET" -binary | base64)

  # Отправьте запрос
  curl -X GET "$URL" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: $API_KEY" \
    -H "X-Signature: $SIGNATURE"
  ```
</CodeGroup>

***

## Пример ответа

```json theme={null}
{
  "paymentOptions": [
    {
      "code": "sberbank",
      "name": "Сбербанк"
    },
    {
      "code": "tbank",
      "name": "Т-Банк"
    },
    {
      "code": "alfabank",
      "name": "Альфа-Банк"
    },
    {
      "code": "vtb",
      "name": "ВТБ"
    },
    {
      "code": "raiffeisenbank",
      "name": "Райффайзенбанк"
    },
    {
      "code": "gazprombank",
      "name": "Газпромбанк"
    },
    {
      "code": "ozon",
      "name": "Ozon Банк"
    },
    {
      "code": "yoomoney",
      "name": "ЮMoney"
    },
    {
      "code": "wbbank",
      "name": "Вайлдберриз Банк"
    }
  ]
}
```

***

## Поля ответа

| Поле                    | Тип      | Описание                                                                                                                                         |
| ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `paymentOptions`        | `array`  | Массив доступных банков для выбранного метода оплаты (230+ банков и платежных систем)                                                            |
| `paymentOptions[].code` | `string` | Код банка. Используйте в параметре `paymentOption` при создании заявки. Примеры: `"sberbank"`, `"tinkoff"`, `"alfabank"`, `"ozon"`, `"yoomoney"` |
| `paymentOptions[].name` | `string` | Название банка на русском языке                                                                                                                  |