Список тарифов — API Плати в Пути

GET/api/partner/v1/tariffs

Scope: любой ключ

Возвращает тарифы, включённые для вашего аккаунта. Тариф, исчезнувший из списка, снят с продажи: новые карты на нём выпустить нельзя. Уже выпущенных карт это не касается — их цена зафиксирована при выпуске.

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

TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" "GET" "/api/partner/v1/tariffs" "" \
  | openssl dgst -sha256 -hmac "$PP_SECRET" -hex | awk '{print $NF}')

curl -sS -X GET "https://api.plativputi.com/api/partner/v1/tariffs" \
  -H "X-Key-Id: $PP_KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"

const res = await pp("GET", "/tariffs");

res = pp("GET", "/tariffs")

$res = pp('GET', '/tariffs');

pp() — функция-обёртка с подписью из раздела Аутентификация и подпись.

Ответ

200 OK — ListTariffsOutputBody

Поле	Тип	Обяз.	Описание
`items`	array<TariffDTO>	да	Тарифы, включённые для аккаунта
`items[].close_fee`	string (decimal)	да	Комиссия за закрытие карты, USD
`items[].close_refund_fee_pct`	string (decimal)	да	Процент, удерживаемый с остатка закрытой карты; остальное возвращается на баланс. 0 — возврат целиком
`items[].description`	string	нет	Описание тарифа в свободной форме
`items[].id`	string	да	Идентификатор тарифа — передавайте в `POST /cards`
`items[].issue_fee`	string (decimal)	да	Разовая комиссия за выпуск, USD
`items[].max_topup`	string (decimal)	нет	Максимальная сумма зачисления на карту по тарифу, USD. Нет поля — нет максимума
`items[].min_topup`	string (decimal)	нет	Минимальная сумма зачисления на карту по тарифу, USD. Нет поля — нет минимума
`items[].name`	string	да	Название продукта
`items[].topup_fee_const`	string (decimal)	да	Фиксированная часть комиссии пополнения, USD
`items[].topup_fee_pct`	string (decimal)	да	Комиссия пополнения в процентах. С баланса списывается брутто, на карту приходит нетто
`items[].tx_fee_declined`	string (decimal)	да	Списывается за каждую отклонённую транзакцию по карте, USD
`items[].tx_fee_ok`	string (decimal)	да	Списывается за каждую одобренную транзакцию по карте, USD

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

{
  "items": [
    {
      "id": "3f6c2a1e-8b4d-4e2a-9c71-5d0e8f1a2b34",
      "name": "Visa Virtual USD",
      "description": "Виртуальная карта для онлайн-оплат",
      "issue_fee": "5",
      "close_fee": "1",
      "close_refund_fee_pct": "0",
      "topup_fee_pct": "3",
      "topup_fee_const": "0.5",
      "tx_fee_ok": "0.2",
      "tx_fee_declined": "0.5",
      "min_topup": "10",
      "max_topup": "5000"
    }
  ]
}