Подтверждение перевода

Уведомляет систему о том, что клиент совершил перевод. После подтверждения платёж переходит в статус PROCESSING и ожидает верификации.

Endpoint

POST /v1/payments/{id}/confirm

Параметры пути

Параметр	Тип	Описание
id	string	ID платежа (UUID)

Параметры запроса

Запрос использует multipart/form-data.

Параметр	Тип	Обязательный	Описание
attachment	file	Нет	Чек перевода (изображение, макс 10MB)

Пример запроса

curl -X POST https://api.settler.pw/api/v1/payments/550e8400-e29b-41d4-a716-446655440000/confirm \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: calculated-signature" \
  -F "[email protected]"

Без файла:

curl -X POST https://api.settler.pw/api/v1/payments/550e8400-e29b-41d4-a716-446655440000/confirm \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: calculated-signature"

Ответ

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "ext_id": "order_12345",
  "amount": 5000,
  "currency": "RUB",
  "status": "PROCESSING",
  "method": "SBP",
  "requisites": {
    "type": "sbp",
    "value": "+79001234567",
    "bank": "sberbank",
    "holder": "Иван И."
  },
  "payment_url": "https://pay.settler.pw/invoice?id=550e8400-e29b-41d4-a716-446655440000",
  "valid_until": "2026-01-30T12:30:00Z",
  "created_at": "2026-01-30T12:15:00Z",
  "message": "Transfer confirmation received, waiting for verification"
}

Статусы после подтверждения

После вызова этого метода платёж переходит в статус PROCESSING. Далее возможны следующие статусы:

Статус	Описание
COMPLETED	Платёж успешно подтверждён системой
CANCELLED	Платёж отменён (перевод не найден)

Ошибки

Код	HTTP	Описание
PAY_001	500	Внутренняя ошибка
PAY_006	404	Платёж не найден
PAY_008	400	Платёж не может быть подтверждён (не в статусе PENDING)

Варианты использования

1. Прямой вызов API

Мерчант сам отображает реквизиты клиенту и вызывает /confirm когда клиент подтверждает оплату:

Мерчант -> POST /payments -> Получает реквизиты
Мерчант -> Показывает реквизиты клиенту
Клиент -> Делает перевод
Клиент -> Нажимает "Я оплатил" на сайте мерчанта
Мерчант -> POST /payments/{id}/confirm

2. Payment Page (опционально)

Можно перенаправить клиента на нашу страницу оплаты payment_url:

Мерчант -> POST /payments -> Получает payment_url
Мерчант -> Редиректит клиента на payment_url
Клиент -> Видит реквизиты на странице
Клиент -> Делает перевод
Клиент -> Нажимает "Я оплатил" на странице
Система -> Автоматически вызывает /confirm