Для AI-агентов: markdown этой страницы — /docs/api-op-refundorder.md · индекс документации — /llms.txt
refundOrder
Обновлено
POST /api/v1/orders/{order_id}/refunds
refundOrder
#Авторизация и права
Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.
| Поле | Значение |
|---|
| security.0.hubApiKey | [] |
| security.1.hubBearer | [] |
| securitySchemes.hubApiKey.in | "header" |
| securitySchemes.hubApiKey.name | "X-Api-Key" |
| securitySchemes.hubApiKey.type | "apiKey" |
| securitySchemes.hubBearer.scheme | "bearer" |
| securitySchemes.hubBearer.type | "http" |
| x-required-scopes | ["orders:write"] |
#Параметры запроса
| Поле | Значение |
|---|
| 0.description | "Required for POST with a body. Same-key replay; changed body returns 422." |
| 0.in | "header" |
| 0.name | "Idempotency-Key" |
| 0.required | true |
| 0.schema | 0.schema |
| 1.in | "path" |
| 1.name | "order_id" |
| 1.required | true |
| 1.schema | 1.schema |
#Тело запроса
| Поле | Значение |
|---|
| content.application/json.schema | RefundRequest |
| required | true |
#Ответы
| Поле | Значение |
|---|
| 200.content.application/json.schema | RefundResponse |
| 200.description | "A body with scope prepares a refund and asks the owner for approval; a body with action_id runs the approved one." |
#Ошибки
| Поле | Значение |
|---|
| 400.content.application/problem+json.schema | ProblemDetails |
| 400.description | "A strict body, path or query is rejected" |
| 401.content.application/problem+json.schema | ProblemDetails |
| 401.description | "Missing, invalid, expired or revoked authentication" |
| 403.content.application/problem+json.schema | ProblemDetails |
| 403.description | "Missing scope, or a credential that names no actor (FORBIDDEN)" |
| 404.content.application/problem+json.schema | ProblemDetails |
| 404.description | "The addressed object is not in this business" |
| 409.content.application/problem+json.schema | ProblemDetails |
| 409.description | "A conflict with the current state" |
| 422.content.application/problem+json.schema | ProblemDetails |
| 422.description | "A domain refusal with its own code" |
| 429.content.application/problem+json.schema | ProblemDetails |
| 429.description | "Per-tool rate limit exceeded" |
| 500.content.application/problem+json.schema | ProblemDetails |
| 500.description | "Unexpected failure" |
#Дополнительные условия
| Поле | Значение |
|---|
| description | "A body with scope prepares a refund and asks the owner for approval; a body with action_id runs the approved one." |
| operationId | "refundOrder" |
| tags | ["orders"] |
| x-idempotency | "generic-cache" |