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

Request

Создаёт request на дополнительную оплату по услуге.

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

корректность тела запроса
что услуга service_id существует
что текущий пользователь является владельцем/мастером этой услуги

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

action = SURCHARGE
source_request_id = surcharge_record_request.id
кнопки PAY / REJECT
payload соответствует SurchargeRequestPayload
для салонной услуги sender_id сохраняется как salon_id

Требования:

требуется JWT
endpoint доступен мастеру-владельцу услуги
для салонной услуги endpoint доступен владельцу салона и админу с правом RECORD_CREATE

Security

bearerAuth or jwtCookie

Bodyapplication/jsonrequired

service_idinteger, (int64), >= 1required

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

Example:501

receiver_idinteger, (int64), >= 1required

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

Example:42

suminteger, [ 1 .. 1000000 ]required

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

Example:1500

reasonstring, [ 1 .. 1000 ] charactersrequired

Причина дополнительной оплаты.

Example:"Доплата за дополнительные материалы"

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

Responses

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

Bodyapplication/json

codeErrorstring or nullrequired

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

successbooleanrequired

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

Example:true

messagestringrequired

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

Example:"OK"

error_codestring or null(ERROR_CODE)required

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

Enum:"invalid_body""unauthorized""not_found""conflict""object_modified_by_another_thread""action_too_late""too_many_request""code_is_gone""forbidden""user_blocked"

Example:null

dataany or nullrequired

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

Example:null

Response

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