Платежи
Платежи по заказам (и связанные операции): создание, смена статуса, удаление.
Базовый путь: /api/integrations/v1/paymentsПрава: payments.read, payments.write, payments.delete
Суммы и цены
В теле (amount) | копейки, целое ≥ 1 |
В snapshot ответа (amount) | рубли |
module_id — id способа оплаты из GET /modules → payment.
Список и карточка
| Метод | URL | Право |
|---|---|---|
GET | /payments | payments.read |
GET | /payments/{id} | payments.read |
Query списка: since, order_id, per_page, cursor.
Snapshot:
json
{
"id": 7,
"order_id": 42,
"user_id": 10,
"status": "pending",
"type": "direct",
"method": "direct",
"amount": 1500,
"transaction": null,
"pickup_point_id": 1,
"created_at": "2026-07-15T14:30:00+03:00",
"updated_at": "2026-07-15T14:30:00+03:00"
}Создать платёж
POST /payments — payments.write → 201
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
order_id | int|null | нет | Заказ |
user_id | int|null | нет | Иначе берётся из заказа |
module_id | int|null | условно | Способ оплаты; иначе из order.payment_id; без модуля → 422 |
amount | int≥1 | нет* | Копейки; по умолчанию сумма позиций заказа; ≤0 → 422 |
status | string | нет | pending | confirmed | refunded | canceled | rejected (default pending) |
type | string | нет | direct | balance_deposit | balance_withdraw (default direct) |
meta | object | нет | Произвольные данные |
bash
curl -sS -X POST "https://ВАШ_ДОМЕН/api/integrations/v1/payments" \
-H "Authorization: Bearer pp_abc123:ВАШ_СЕКРЕТ" \
-H "Content-Type: application/json" \
-d '{
"order_id": 42,
"module_id": 3,
"amount": 150000,
"status": "pending"
}'json
{
"ok": true,
"payment": {
"id": 7,
"order_id": 42,
"user_id": 10,
"status": "pending",
"type": "direct",
"method": "direct",
"amount": 1500,
"pickup_point_id": 1,
"created_at": "2026-07-15T14:30:00+03:00",
"updated_at": "2026-07-15T14:30:00+03:00"
}
}Изменить / удалить
PATCH /payments/{id} — payments.write Тело: amount (копейки), status, meta. Неизвестный status → 422.
bash
curl -sS -X PATCH "https://ВАШ_ДОМЕН/api/integrations/v1/payments/7" \
-H "Authorization: Bearer pp_abc123:ВАШ_СЕКРЕТ" \
-H "Content-Type: application/json" \
-d '{"status":"confirmed"}'DELETE /payments/{id} — payments.delete Ответ: { "ok": true, "deleted": true, "payment_id": 7 }.