POST /api/pay
Регистрирует факт оплаты начисления.
🔐 Авторизация
Body parameters
| Параметр | Тип/Формат | Обязательный | Описание | Пример |
|---|
| id | string<uuid> | ✅ | Идентификатор начисления | 452f081a-7612-48e1-bc4e-89d6cea366e7 |
| txnId | string<от 1 до 100 символов> | ✅ | Идентификатор транзакции на стороне клиента | 1234567891111 |
| txnDate | string<ISO 8601> | ✅ | Дата транзакции на строне клиента | 2024-01-01T12:00:00Z |
| amount | string<^\d9(.\d2)?$> | ✅ | Сумма платежа | 1500.75 |
| receiptUrl | string<URL> | ❌ | Ссылка на чек | https://example.com/receipt.pdf |
Пример запроса
bashcurl -X POST "https://accruals-gateway.doma.ai/api/pay" \
-H "Content-Type: application/json" \
-H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=" \
-d '{
"id": "452f081a-7612-48e1-bc4e-89d6cea366e7",
"txnId": "1234567891111",
"txnDate": "2024-01-01T12:00:00Z",
"amount": "1500.75",
"receiptUrl": "https://example.com/receipt.pdf"
}'
Тело запроса
json{
"id": "452f081a-7612-48e1-bc4e-89d6cea366e7",
"txnId": "1234567891111",
"txnDate": "2024-01-01T12:00:00Z",
"amount": "1500.75",
"receiptUrl": "https://example.com/receipt.pdf"
}
Ответ
| Параметр | Тип/Формат | Обязательный | Описание | Пример |
|---|
| txnId | string<от 1 до 100 символов> | ✅ | Идентификатор транзакции (переданный в запросе) | 1234567891111 |
| txnDate | string<datetime> | ✅ | Дата транзакции в формате ISO 8601 | 2025-12-04T22:25:01.243Z |
| regDate | string<datetime> | ✅ | Дата регистрации платежа в системе в формате ISO 8601 | 2025-12-09T12:59:34.887Z |
Пример ответа
json{
"data": {
"txnId": "1234567891111",
"txnDate": "2025-12-04T22:25:01.243Z",
"regDate": "2025-12-09T12:59:34.887Z"
}
}
Коды ошибок
| Код ошибки | HTTP статус | Сообщение | Причина | Решение |
|---|
VALIDATION_FAILED | 400 | Invalid format of input | Ошибка валидации параметров | Проверьте формат вводимых данных |
PAYMENT_ALREADY_EXISTS | 400 | Invalid format of input | Платеж с переданным txnId уже зарегистрирован | Использовать другой txnId |
ACCRUAL_NOT_FOUND | 404 | Accrual is not found | Начисление по id не найдено | Уточните id в запросе |
INTERNAL_SERVER_ERROR | 500 | Internal server error | Внутренняя ошибка сервера | Попробуйте позже или обратитесь в поддержку |
