Список услуг

Список услуг

POST /v2/services · Статус API: stable · Подпись: обязательна

Возвращает список услуг и их обязательные поля (requiredFields) для создания платежа.

Тело запроса

ПараметрТипОбязательныйОписание
fromNumberОпциональноСмещение. По умолчанию 0 (с первой услуги).
sizeNumberОпциональноКоличество записей. По умолчанию 20, максимум 50.
filter.statusString[]ОпциональноENABLED, DISABLED, INACTIVE. По умолчанию [ENABLED, DISABLED].
filter.parentIdStringОпциональноID родительской категории. Без него вернутся все услуги.
localeStringОпциональноЯзык названий: EN, KY, RU. По умолчанию EN.
queryStringОпциональноПоиск по названию (на всех поддерживаемых языках).

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

POST /v2/services
POST /v2/services HTTP/1.1
Host: api.paymentsgateway.averspay.kg
Content-Type: application/json
signature: <signature>
x-api-key: <apiKey>
x-api-timestamp: 1719900000000 // Use Date.now() for the current timestamp.

{
  "from": 0,
  "query": "",
  "locale": "RU",
  "size": 20,
  "filter": { "parentId": "kyrgyzstan" }
}

Пример ответа (сокращён)

200 OK — список услуг
{
  "services": [
    {
      "id": "o-kg",
      "country": "Kyrgyzstan",
      "maxAmount": 10000,
      "minAmount": 1,
      "name_ru": "О!",
      "parentId": "kg-mobile",
      "requiredFields": [
        { "fieldId": "account.value", "inputMask": "000 000 000", "keyboardType": "PHONE", "label_ru": "Номер телефона", "prefix": "+996 " },
        { "fieldId": "service", "keyboardType": "TEXT", "value": "5" },
        { "fieldId": "total", "keyboardType": "MONEY", "label_ru": "Сумма" }
      ],
      "status": "ENABLED"
    }
  ],
  "statusCode": 200,
  "total": 20
}