# 提交 Ethoca 预警处理结果

> 提交 Ethoca 预警的处理结果和退款状态。

```yaml
openapi: 3.1.0
info:
  title: 提交 Ethoca 预警处理结果
  version: 1.0.0
  description: 提交 Ethoca 预警的处理结果和退款状态。
paths:
  /ethoca/agency-cw/outcome:
    post:
      summary: 提交 Ethoca 预警处理结果
      description: 提交 Ethoca 预警的处理结果和退款状态。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号；用于限定要处理的预警所属商户账户。
                ethocaId:
                  type: string
                  description: Ethoca 预警唯一标识，用于指定要提交处理结果的预警记录。
                outcome:
                  type: string
                  description: 商户对该预警采取的处置结果，回报给 Ethoca / 发卡行。
                  enum:
                    - stopped
                    - partially_stopped
                    - previously_cancelled
                    - missed
                    - notfound
                    - account_suspended
                    - in_progress
                    - shipper_contacted
                    - other
                    - resolved
                    - previously_refunded
                    - unresolved_dispute
                  x-enum-descriptions:
                    stopped: 订单已停止。
                    partially_stopped: 订单部分停止。
                    previously_cancelled: 交易已被取消。
                    missed: 已过期，订单已发货或服务已消费。
                    notfound: 未找到相关订单。
                    account_suspended: 账户已被暂停。
                    in_progress: 正在处理该请求。
                    shipper_contacted: 已联系发货方并尝试拦截货物。
                    other: 其他未列出的情况。
                    resolved: 已解决。
                    previously_refunded: 已退款。
                    unresolved_dispute: 未解决的争议。
                refundStatus:
                  type: string
                  description: 与本次处置对应的退款状态，向 Ethoca / 发卡行说明资金是否已退还。
                  enum:
                    - refunded
                    - not refunded
                    - not settled
                  x-enum-descriptions:
                    refunded: 已完成退款。
                    not refunded: 未进行退款。
                    not settled: 退款处理中。
                sign:
                  type: string
                  description: 请求签名字符串；生成方式详见[请求签名](/zh/payments/get-started/request-signing)。
              required:
                - merchantNo
                - ethocaId
                - outcome
                - refundStatus
                - sign
            examples:
              submit-ethoca-alert-outcome:
                summary: 提交 Ethoca 预警处理结果
                value:
                  ethocaId: replace_with_ethoca_id
                  merchantNo: replace_with_merchant_no
                  outcome: previously_refunded
                  refundStatus: refunded
                  sign: "{{SIGN}}"
      responses:
        "200":
          description: Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: 响应码；`20000`
                      表示请求处理成功，其余为错误码。完整码表见[响应码](/zh/payments/api-reference/response-codes)。
                  respMsg:
                    type: string
                    description: 响应码对应的可读说明。
                  data:
                    type: object
                    properties:
                      success:
                        type: boolean
                        description: 本次预警处置结果是否提交成功；`true` 表示 Onerway 已受理本次回报，预警记录中的最新 `outcome` /
                          `refundStatus` 可通过[查询 Ethoca
                          预警接口](/zh/payments/api-reference/endpoints/query-ethoca-alerts)读取。
                      sign:
                        type: string
                        description: 响应签名字符串，可用于校验响应数据完整性。
                    description: 业务数据对象，包含本次预警处理请求是否成功。
```