Объект платежа
Объект платежа (payment) содержит всю информацию о платеже, актуальную на текущий момент времени. Он формируется при создании платежа и приходит в ответ на любой запрос, связанный с платежами.
| Значение | Тип | Описание |
|---|---|---|
| id | string | Идентификатор платежа |
| project_id | string | Идентификатор проекта |
| created_at | string | Время создания платежа |
| canceled_at | string | Время отмены платежа (status: canceled) |
| status | string | Статус платежа. Возможные значения: pending,succeeded,canceled |
| error | object | Объекта ошибки платежа (status: canceled) |
| confirmation_url | string | URL на страницу подтверждения платежа плательщиком (см примечание ниже) |
| payment_method | string | Код платежной системы |
| payer | object | Объект плательщика |
| account | string | Идентификатор абонента в системе партнера |
| description | string | Описание транзакции (не более 128 символов) |
| amount | float | Сумма платежа в рублях например 10.00) |
| refunded_amount | float | Сумма, которая вернулась пользователю. Присутствует, если у этого платежа есть успешные возвраты |
| currency | string | Код валюты в формате ISO-4217 |
| test | boolean | Признак тестовой операции |
Объект плательщика:
| Значение | Тип | Описание |
|---|---|---|
| id | string | Идентификатор плательщика |
| phone | string | Телефон плательщика в международном формате например 79000000000 |
| saved | boolean | С помощью сохраненного плательщика можно проводить безакцептные списания |
Объект ошибки платежа:
| Значение | Тип | Описание |
|---|---|---|
| code | string | Код ошибки платежа |
| description | string | Описание ошибки платежа со стороны платежной системы |
Примечание: URL подтверждения платежа
Для формирования страницы подтверждения платежа на вашем сайте/в приложении необходимо несколько действий:
1. Отправить [GET] запрос на url который пришел в ответе на запрос создания платежа в поле confirmation_url
при этом будет сформировано и отправлено клиенту SMS-сообщение с кодом подтверждения
Ответ на этот запрос - html форма в которую можно ввести код из SMS.
Если предполагается использовать форму вашего сайта/приложения, ответ можно игнорировать, убедившись в том что его код 200 OK
2. Клиент вводит код из SMS в форму на вашем сайте/в приложении
3. Вы отправляете [GET] запрос с кодом как описано в подтверждении платежа
4. Платеж получает статус "подтвержден" и обработка продолжается