# Submit Ethoca alert outcome

> Submit the handling outcome and refund status for an Ethoca alert.

```yaml
openapi: 3.1.0
info:
  title: Submit Ethoca alert outcome
  version: 1.0.0
  description: Submit the handling outcome and refund status for an Ethoca alert.
paths:
  /ethoca/agency-cw/outcome:
    post:
      summary: Submit Ethoca alert outcome
      description: Submit the handling outcome and refund status for an Ethoca alert.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Merchant number assigned by Onerway. It limits the outcome
                    submission to alerts under one merchant account.
                ethocaId:
                  type: string
                  description: Unique Ethoca alert identifier identifying the alert record whose
                    outcome is being submitted.
                outcome:
                  type: string
                  description: Merchant outcome for this alert, reported to Ethoca or the issuer
                    network.
                  enum:
                    - stopped
                    - partially_stopped
                    - previously_cancelled
                    - missed
                    - notfound
                    - account_suspended
                    - in_progress
                    - shipper_contacted
                    - other
                    - resolved
                    - previously_refunded
                    - unresolved_dispute
                  x-enum-descriptions:
                    stopped: Order stopped.
                    partially_stopped: Order partially stopped.
                    previously_cancelled: Transaction previously cancelled.
                    missed: Expired; the order has shipped or the service has been consumed.
                    notfound: Related order not found.
                    account_suspended: Account suspended.
                    in_progress: Request in progress.
                    shipper_contacted: Shipper contacted to attempt shipment interception.
                    other: Other situation not listed.
                    resolved: Resolved.
                    previously_refunded: Previously refunded.
                    unresolved_dispute: Unresolved dispute.
                refundStatus:
                  type: string
                  description: Refund status corresponding to this outcome, explaining whether
                    funds have been returned.
                  enum:
                    - refunded
                    - not refunded
                    - not settled
                  x-enum-descriptions:
                    refunded: Refund completed.
                    not refunded: No refund was issued.
                    not settled: Refund is processing.
                sign:
                  type: string
                  description: Request signature string. See [Request
                    signing](/payments/get-started/request-signing) for how to
                    generate it.
              required:
                - merchantNo
                - ethocaId
                - outcome
                - refundStatus
                - sign
            examples:
              submit-ethoca-alert-outcome:
                summary: Submit Ethoca alert outcome
                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` means the outcome submission request was processed
                      successfully. Other values are error codes. See [Response
                      codes](/payments/api-reference/response-codes)."
                  respMsg:
                    type: string
                    description: Human-readable message for the response code.
                  data:
                    type: object
                    properties:
                      success:
                        type: boolean
                        description: Whether this alert outcome was submitted successfully. `true` means
                          Onerway accepted this report; read the latest
                          `outcome` and `refundStatus` through [Query Ethoca
                          alerts](/payments/api-reference/endpoints/query-ethoca-alerts).
                      sign:
                        type: string
                        description: Response signature string for verifying response integrity.
                    description: Business data object indicating whether this alert outcome
                      submission succeeded.
```