Payment.Get
Возвращает текущее состояние платежа и последней операции отмены или возврата.
Входные параметры
| Название | Тип данных | Обязательность | Описание |
|---|---|---|---|
| payment_id | string | Условно обязательный | Локальный id платежа VCR из ответа Payment.Create или Payment.Start |
| external_id | string | Условно обязательный | Идентификатор внешнего клиента, переданный в Payment.Start |
Нужно передать payment_id или external_id. Если переданы оба поля, используется payment_id.
Пример запроса по payment_id
{
"jsonrpc": "2.0",
"method": "Payment.Get",
"params": {
"payment_id": "58847e73-b40b-4746-8a07-44582991bd6b"
},
"auth": "a2Fzc2E6a2FzMTIzNDU2",
"id": 1
}
Пример запроса по external_id
{
"jsonrpc": "2.0",
"method": "Payment.Get",
"params": {
"external_id": "ORDER-2026-000123"
},
"auth": "a2Fzc2E6a2FzMTIzNDU2",
"id": 1
}
Выходные параметры
| Название | Тип данных | Описание |
|---|---|---|
| id | string | Локальный id платежа в VCR |
| datetime | string | Дата и время создания платежа |
| payment_system_id | int32 | ID платёжной системы |
| payment_id | string | id платежа во внешней платёжной системе |
| status | int32 | Статус платежа |
| amount | int64 | Сумма платежа в тийинах |
| receipt_id | string | id связанного чека в VCR; до закрытия чека значение пустое |
| phone | string | Телефон плательщика, если доступен |
| rrn | string | Идентификатор карточной оплаты, если доступен |
| slip | string | SLIP терминала, если доступен |
| card_type_id | int32 | Тип карты: 0 — не задан, 1 — корпоративная, 2 — личная, 3 — социальная |
| card_number | string | Маскированный номер карты, если доступен |
| external_id | string | Для Payment.Start — идентификатор внешнего клиента; для устаревших сценариев Payment.Create поле сохраняет прежнее назначение корреляционного ключа |
| invoice_id | string | id QR-счёта, если применимо |
| qr_text | string | Текст или ссылка QR-кода, если применимо |
| provider_status | int32 | Статус платёжной системы, если применимо |
| fiscal_module | string | Заводской номер фискального модуля, переданный платёжной системе, если применимо |
| receipt_send_status | int32 | Статус передачи фискального чека платёжной системе |
| receipt_send_error | string | Ошибка передачи фискального чека, если она возникла |
| receipt_sent_at | string | Дата и время передачи фискального чека |
| refund | object | Последняя операция отмены или возврата; поле отсутствует, если операций не было |
| confirmation | object | Допустимое действие оператора; поле отсутствует, если подтверждение не требуется или платёж завершён |
| poll_after | int32 | Рекомендованная задержка до следующего Payment.Get, в секундах |
Объект confirmation содержит тип действия type и признак обязательности required. Для type = "token" используется Payment.Confirm.
Поля объекта refund:
| Название | Тип данных | Описание |
|---|---|---|
| refund_id | string | id операции отмены или возврата в VCR |
| payment_id | string | Локальный id исходного платежа |
| payment_system_id | string | Машинное имя платёжной системы |
| amount | int64 | Сумма операции в тийинах |
| status | int32 | 1 — создана, 2 — выполняется, 4 — подтверждена провайдером, 5 — ожидает фискализации, 6 — завершена, 8 — ошибка, 9 — результат неизвестен |
| mode | int32 | Режим выполнения операции |
| provider_refund_id | string | id операции во внешней платёжной системе, если доступен |
| refund_receipt_id | string | id возвратного чека, если операция связана с чеком |
| error | string | Описание ошибки, если она возникла |
| resolution | int32 | Результат ручного разрешения неопределённой операции, если применимо |
| resolved_by | string | Пользователь, разрешивший неопределённую операцию |
| resolved_at | string | Дата и время ручного разрешения |
| created_at | string | Дата и время создания операции |
| updated_at | string | Дата и время последнего изменения операции |
Пример ответа
{
"jsonrpc": "2.0",
"result": {
"id": "58847e73-b40b-4746-8a07-44582991bd6b",
"datetime": "2026-09-24 15:30:00",
"payment_system_id": 6,
"payment_id": "1234567890",
"status": 3,
"amount": 90000,
"receipt_id": "",
"phone": "998901234567",
"rrn": "",
"slip": "",
"card_type_id": 2,
"card_number": "8600******8331",
"external_id": "ORDER-2026-000123"
},
"ok": true,
"id": 1
}