Интеграция по API

Webhooks

Approved

Заявка одобрена, ожидается оплата.


{
  "id": "test_id",
  "status": "approved",
  "amount": 10000.56,
  "residual_amount": 7500.42,
  "demo": false,
  "client_info": {
    "first_name": "Иван",
    "last_name": "И.",
    "middle_name": "Иванович",
    "email": "t**@y*.ru",
    "phone": "+79003332211",
    "birthdate": "1997-05-15"
  },
  "payment_schedule": [
    {
      "payment_date": "2026-05-01",
      "amount": 2500.14,
      "status": "hold"
    },
    {
      "payment_date": "2026-05-15",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2026-05-29",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2026-06-12",
      "amount": 2500.14,
      "status": "scheduled"
    }
  ],
  "cid": "78eb2e2f-047e-4257-a881-40f3405be4e2",
  "signature": "c74ab465dc182fe335add39f1f62654824cdbee9be7ac968f0b67698e6048cc9"
}

Rejected

Заявка отклонена, клиенту стоит выбрать другой способ оплаты.


{
  "id": "test_id",
  "status": "rejected",
  "amount": 10000.56,
  "residual_amount": 0,
  "demo": false,
  "client_info": {
    "first_name": "Иван",
    "last_name": "И.",
    "middle_name": "Иванович",
    "email": "t**@y*.ru",
    "phone": "+79003332211",
    "birthdate": "1997-05-15"
  },
  "cid": "c3b24af5-9771-425d-a0f4-0d49c8bebb6a",
  "signature": "e763ab051f6adce22c84102fc721cac582d0de27904b7fe3f0d1571599a266dc"
}

Canceled

Заявка была по какой-либо причине отменена.


{
  "id": "test_id",
  "status": "canceled",
  "amount": 10000.56,
  "residual_amount": 0,
  "demo": false,
  "cid": "c04593f4-9367-4cbe-9313-2f20e5ce8b7f",
  "signature": "419b20eb942c7f9dfe429c02e3558bc0dee1ee20e24d8d2038f6dbeda3a2b008"
}

Wait for Commit

Заявка была одобрена, средства захолдированы, Т‑Банк ожидает commit от партнера (готов принять commit от партнера).


{
  "id": "test_id",
  "status": "wait_for_commit",
  "amount": 10000.56,
  "residual_amount": 7500.42,
  "demo": false,
  "client_info": {
    "first_name": "Иван",
    "last_name": "И.",
    "middle_name": "Иванович",
    "email": "t**@y*.ru",
    "phone": "+79003332211",
    "birthdate": "1997-05-15"
  },
  "payment_schedule": [
    {
      "payment_date": "2026-05-01",
      "amount": 2500.14,
      "status": "hold"
    },
    {
      "payment_date": "2026-05-15",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2026-05-29",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2026-06-12",
      "amount": 2500.14,
      "status": "scheduled"
    }
  ],
  "cid": "faf356cf-7469-4597-a373-73185b1fb928",
  "signature": "45f24a5a07af5c2e237a487cf86eb5d1dd1c0cb6a2824d65d9f1a8e2cc4fea9c"
}

Committed

ИМ прислал commit, первый платеж будет списан (до этого он был захолдирован, вскоре будет списан).


{
  "id": "test_id",
  "status": "committed",
  "amount": 10000.56,
  "residual_amount": 7500.42,
  "demo": false,
  "client_info": {
    "first_name": "Иван",
    "last_name": "И.",
    "middle_name": "Иванович",
    "email": "t**@y*.ru",
    "phone": "+79003332211",
    "birthdate": "1997-05-15"
  },
  "payment_schedule": [
    {
      "payment_date": "2026-05-01",
      "amount": 2500.14,
      "status": "hold"
    },
    {
      "payment_date": "2026-05-15",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2026-05-29",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2026-06-12",
      "amount": 2500.14,
      "status": "scheduled"
    }
  ],
  "cid": "0c0876b3-d810-470d-ad81-37bc217ffa9b",
  "signature": "9664ffbc13d2392531506194da687090854acebbb540383c8ac30f70b42f6ae4"
}

Completed

Первый платеж по заявке был списан (подтверждение того, что платеж был списан).


{
  "id": "test_id",
  "status": "completed",
  "amount": 10000.56,
  "residual_amount": 7500.42,
  "demo": false,
  "client_info": {
    "first_name": "Иван",
    "last_name": "И.",
    "middle_name": "Иванович",
    "email": "t**@y*.ru",
    "phone": "+79003332211",
    "birthdate": "1997-05-15"
  },
  "payment_schedule": [
    {
      "payment_date": "2026-05-01",
      "amount": 2500.14,
      "status": "hold"
    },
    {
      "payment_date": "2026-05-15",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2026-05-29",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2026-06-12",
      "amount": 2500.14,
      "status": "scheduled"
    }
  ],
  "cid": "6d541f68-a266-440e-bca0-240594247cb1",
  "signature": "701a8102c9593ece3e0d622f60f34f33079bb6ed9acba1d8fc7ba9f13870b345"
}

Методика проверки нотификации

Запросить статус заявки через API партнера для проверки, что статус из уведомления актуален.
Проверить IP адрес. Уведомления банка приходят с маски сети 91.194.226.0/23, соответственно IP адрес первого хоста — 91.194.226.1 и IP адрес последнего хоста — 91.194.227.254, хостов в сети 510.
Верификация подписи signature в вебхуке с помощью секрета по алгоритму SHA-256