Объект платежа и статусы
Один и тот же объект возвращают создание (POST /v1/payments), безопасный повтор и чтение (GET /v1/payments/{reference}). Он не содержит внутренних идентификаторов или данных провайдера.
Поля
| Поле | Тип | Описание |
|---|---|---|
reference | строка | Публичный идентификатор платежа Eleven Pay. Используйте его в GET. |
merchant_order_id | строка | null | Ваш идентификатор заказа. |
external_account_number | строка | null | Номер платежа для плательщика: 7 цифр, формируется Eleven Pay, уникален в пределах вашей организации. Для сверки используйте reference; формат номера не является частью контракта. |
status | строка | Статус платежа (см. ниже). |
amount | строка | Сумма, ровно два знака после точки ("1500.00"). |
currency | строка | "KZT". |
environment | строка | Окружение ключа, создавшего платёж: live или test. |
created_at | строка (ISO 8601, UTC) | Момент создания платежа. |
action | объект | null | Действие оплаты для клиента (см. Действия оплаты). |
{
"reference": "ep1_7t4k2m8q9x3v6b1n5c0d2f4a8h",
"merchant_order_id": "order_demo_1001",
"external_account_number": "4821937",
"status": "succeeded",
"amount": "1500.00",
"currency": "KZT",
"environment": "test",
"created_at": "2024-09-05T11:59:30Z",
"action": null
}Статусы платежа
| Статус | Значение | Что делать мерчанту |
|---|---|---|
pending | Платёж создан, ещё не финальный. | Показать действие / ожидать. |
processing | Платёж обрабатывается. | Ожидать. |
succeeded | Успешное завершение (финальный). | Можно выполнять выдачу — после ваших проверок (заказ, сумма, валюта). |
failed | Неуспешно (финальный). | Не выдавать. |
cancelled | Отменён (финальный). | Не выдавать. |
outcome_unknown | Результат не удалось установить. | Сверяйтесь; не считайте отказом. |
succeeded, failed, cancelled — финальные состояния. outcome_unknown — это состояние неопределённости результата, требующее сверки, а не финальный отказ.
outcome_unknown — важно
Не принимайте решений по одному только outcome_unknown
Не выполняйте автоматически на основании только outcome_unknown:
- выдачу товара/услуги;
- возврат средств;
- создание дублирующего/заменяющего платежа.
Используйте сверку через GET и свою бизнес‑политику.
Действие и статус — независимы
Действие оплаты (action) и финансовый status — разные понятия. Действие может истечь или исчезнуть (вернуться null), при этом финансовый статус платежа меняется отдельно. Истечение действия не означает автоматически неуспех платежа. См. Действия оплаты.