Для создания нового платежа можно передать только сумму, остальное по желанию. Описание (description) внутреннее, оно видно вам в личном кабинете и помогает находить платёж, клиенту оно не показывается. В ответ вернётся ссылка для оплаты, на которую нужно направить клиента. После создания платёж движется по статусам только вперёд. Актуальный статус можно получить через запрос информации о платеже или через уведомление.

​
Процесс оплаты

Для того, чтобы узнать актуальный статус, можно запросить информацию о платеже или дождаться уведомления.
СтатусТипЗначение
createdпромежуточныйПлатёж создан, маршрут ещё не назначен.
awaiting_paymentпромежуточныйОжидает оплаты клиентом.
paidфинальныйПлатёж успешно оплачен.
expiredфинальныйИстёк срок оплаты.
failedфинальныйПри оплате произошла ошибка.

​
Объект платежа

Объект платежа payment содержит всю информацию о платеже, актуальную на текущий момент. Его возвращает и при создании, и при получении платежа.
​
id
string
Идентификатор платежа.
​
status
string
Статус платежа. См. «Процесс оплаты» выше.
​
amount
string
Сумма платежа в формате "D.DD".
​
currency
string
по умолчанию:"RUB"
Валюта платежа.
​
description
string | null
Описание транзакции (до 128 символов), которое можно видеть в личном кабинете.
​
payload
object
Произвольные данные мерчанта (до 512 байт). Возвращаются в объекте платежа.
​
instructions
object
Данные для оплаты. Присутствуют только в ответе на создание платежа; при получении информации о платеже поле не возвращается.
​
created_at
datetime
Время создания платежа (ISO 8601, UTC).
instructions содержит ссылку для оплаты, на которую нужно направить клиента. 
{ "type": "link", "url": "https://..." }
Ссылка для оплаты приходит в поле instructions только при создании платежа. При последующем получении информации о платеже это поле не возвращается.
Пример объекта
{
  "id": "01jbx9q8h7m2k3n4p5r6s7t8v9",
  "status": "paid",
  "amount": "100.00",
  "currency": "RUB",
  "description": "id:1042",
  "payload": { "order_id": 1042 },
  "created_at": "2026-05-29T13:30:00Z"
}

​
Создание платежа

POST /v1/payments Отправьте запрос и передайте в нём данные для создания платежа. В ответ придёт объект платежа. Параметры тела
​
amount
string | number
обязательно
Сумма в рублях, не более двух знаков после точки.
​
currency
string
по умолчанию:"RUB"
Валюта платежа.
​
description
string | null
Описание транзакции (до 128 символов), которое вы увидите в личном кабинете.
​
payload
object | null
Произвольные данные мерчанта (до 512 байт). Возвращаются в объекте платежа.
Для удобства и чтобы находить платёж в личном кабинете, можно положить свой идентификатор (например, внутренний order_id) в description.
curl https://api.parserpay.io/v1/payments \
  -X POST \
  -H "Authorization: Bearer <project_id>:<api_key>" \
  -H "Idempotency-Key: 7c3b1f0a-9d2e-4a51-8b6c-1f2e3d4c5b6a" \
  -H "Content-Type: application/json" \
  -d '{
        "amount": "100.00",
        "currency": "RUB",
        "description": "id:1042",
        "payload": { "order_id": 1042 }
      }'

​
Информация о платеже

GET /v1/payments/ Запрос позволяет получить информацию о текущем состоянии платежа по его уникальному идентификатору. В ответ придёт объект платежа в актуальном статусе. Параметры пути
​
payment_id
string
обязательно
Идентификатор платежа. Значение поля id (26 символов) из объекта платежа.
curl https://api.parserpay.io/v1/payments/01jbx9q8h7m2k3n4p5r6s7t8v9 \
  -H "Authorization: Bearer <project_id>:<api_key>"