Onerway
POST

Submit Ethoca alert outcome

Use this endpoint to report how an Ethoca alert was handled, including the outcome and refund status associated with the alert.

Request

merchantNo
Merchant number assigned by Onerway. It limits the outcome submission to alerts under one merchant account.
Example:
ethocaId
Unique Ethoca alert identifier identifying the alert record whose outcome is being submitted.
Example:
outcome
Merchant outcome for this alert, reported to Ethoca or the issuer network.
Example:
Allowed values
stopped
Order stopped.
partially_stopped
Order partially stopped.
previously_cancelled
Transaction previously cancelled.
refundStatus
Refund status corresponding to this outcome, explaining whether funds have been returned.
Example:
Allowed values
refunded
Refund completed.
not refunded
No refund was issued.
not settled
Refund is processing.
sign
Request signature string. See Request signing for how to generate it.

Request example

curl -X POST 'https://sandbox-acq.onerway.com/ethoca/agency-cw/outcome' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "ethocaId": "replace_with_ethoca_id",
  "merchantNo": "replace_with_merchant_no",
  "outcome": "previously_refunded",
  "refundStatus": "refunded",
  "sign": "{{SIGN}}"
}'

Response

respCode
20000 means the outcome submission request was processed successfully. Other values are error codes. See Response codes.
respMsg
Human-readable message for the response code.
Business data object indicating whether this alert outcome submission succeeded.

Response example

Example code is unavailable.

No error responses are documented for this endpoint.