Skip to content

Создать запрос на доплату

Request

Создаёт запрос на дополнительную оплату по существующей записи.

Перед созданием сервер проверяет:

  • корректность тела запроса
  • что запись record_id существует и имеет статус BOOKED
  • что receiver_id совпадает с клиентом записи
  • что текущий пользователь вправе действовать от имени исполнителя услуги записи

После создания в Messenger отправляется request-сообщение:

  • action = SURCHARGE
  • source_request_id = surcharge_record_request.id
  • кнопки PAY / REJECT
  • payload соответствует SurchargeRequestPayload

Запрос истекает через service.record.request.surcharge-lifetime после создания (в текущей конфигурации — через 24 часа). Точное время истечения возвращается в request.expires_at сообщения чата.

  • для салонной услуги sender_id сохраняется как salon_id

Требования:

  • требуется JWT
  • endpoint доступен мастеру-владельцу услуги
  • для салонной услуги endpoint доступен владельцу салона и админу с правом RECORD_MANAGE
Security
bearerAuth or jwtCookie
Bodyapplication/jsonrequired
record_idinteger, (int64), >= 1required

Идентификатор записи, по которой создаётся запрос на доплату.

Example:123
receiver_idinteger, (int64), >= 1required

Идентификатор пользователя, который должен оплатить или отклонить доплату.

Example:42
suminteger, [ 1 .. 1000000 ]required

Сумма дополнительной оплаты.

Example:1500
reasonstring, [ 1 .. 1000 ] characters\Srequired

Причина дополнительной оплаты; строка из одних пробельных символов недопустима.

Example:"Доплата за дополнительные материалы"
curl -i -X POST \
  https://felmee.com/api/record/surcharge \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "record_id": 123,
    "receiver_id": 42,
    "sum": 1500,
    "reason": "Доплата за дополнительные материалы"
  }'

Responses

Запрос на доплату успешно создан

Bodyapplication/json
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

Example:null
successbooleanrequired

Флаг успешного выполнения запроса

Example:true
messagestringrequired

Человекочитаемое описание результата

Example:"OK"
error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
Example:null
dataany or nullrequired

Полезная нагрузка. Может быть объектом, массивом или null.

Example:null
Response
{ "success": true, "message": "Surcharge request created successfully", "codeError": null, "error_code": null, "data": null }