Интеграция по 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": "2020-11-20",
      "amount": 2500.14,
      "status": "hold"
    },
    {
      "payment_date": "2020-12-04",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2020-12-18",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2021-01-1",
      "amount": 2500.14,
      "status": "scheduled"
    }
  ]
}

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"
  }
}

Canceled

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


{
  "id": "test_id",
  "status": "canceled",
  "amount": 10000.56,
  "demo": false,
  "residual_amount": 0
}

Committed

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


{
  "id": "test_id",
  "status": "committed",
  "amount": 6000,
  "residual_amount": 4500,
  "demo": false,
  "client_info": {
    "first_name": "Иван",
    "last_name": "И.",
    "middle_name": "Иванович",
    "email": "test@ya.ru",
    "phone": "+79003332211",
    "birthdate": "1997-05-15"
  },
  "payment_schedule": [
    {
      "payment_date": "2020-11-20",
      "amount": 1500,
      "status": "hold"
    },
    {
      "payment_date": "2020-12-04",
      "amount": 1500,
      "status": "scheduled"
    },
    {
      "payment_date": "2020-12-18",
      "amount": 1500,
      "status": "scheduled"
    },
    {
      "payment_date": "2021-01-01",
      "amount": 1500,
      "status": "scheduled"
    }
  ]
}

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": "test@ya.ru",
    "phone": "+79003332211",
    "birthdate": "1997-05-15"
  },
  "payment_schedule": [
    {
      "payment_date": "2020-11-20",
      "amount": 2500.14,
      "status": "hold"
    },
    {
      "payment_date": "2020-12-04",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2020-12-18",
      "amount": 2500.14,
      "status": "scheduled"
    },
    {
      "payment_date": "2021-01-01",
      "amount": 2500.14,
      "status": "scheduled"
    }
  ]
}

Completed

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


{
  "id": "test_id",
  "status": "completed",
  "amount": 6000,
  "residual_amount": 4500,
  "demo": false,
  "client_info": {
    "first_name": "Иван",
    "last_name": "И.",
    "middle_name": "Иванович",
    "email": "test@ya.ru",
    "phone": "+79003332211",
    "birthdate": "1997-05-15"
  },
  "payment_schedule": [
    {
      "payment_date": "2020-11-20",
      "amount": 1500,
      "status": "paid"
    },
    {
      "payment_date": "2020-12-04",
      "amount": 1500,
      "status": "scheduled"
    },
    {
      "payment_date": "2020-12-18",
      "amount": 1500,
      "status": "scheduled"
    },
    {
      "payment_date": "2021-01-01",
      "amount": 1500,
      "status": "scheduled"
    }
  ]
}

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

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