Onerway
POST

查询 Ethoca 预警

该接口用于查询 Ethoca 预警记录,将预警匹配回原交易,并查看最新处理结果和退款状态。

请求

merchantNo
Onerway 分配的商户号;用于限定查询的商户账户范围。
示例:
ethocaId
Ethoca 预警唯一标识;传入后可按单条预警精确查询。
示例:
alertTypes
按预警类型筛选;不同类型对应客户争议、欺诈或拒付等风险来源。
示例:
可选值
CustomerDispute
客户争议预警。
FraudAlert
欺诈预警。
ChargebackAlert
拒付预警。
alertTimeStart
条件:按预警生成时间范围筛选时提供。
预警生成时间范围的起点,格式为 yyyy-MM-dd HH:mm:ss。
示例:
alertTimeEnd
条件:按预警生成时间范围筛选时提供。
预警生成时间范围的终点,格式为 yyyy-MM-dd HH:mm:ss。
示例:
txnTimeStart
条件:按原交易时间范围筛选时提供。
原交易时间范围的起点,格式为 yyyy-MM-dd HH:mm:ss。
txnTimeEnd
条件:按原交易时间范围筛选时提供。
原交易时间范围的终点,格式为 yyyy-MM-dd HH:mm:ss。
outcomeUpdatedTimeStart
条件:按预警处理状态更新时间范围筛选时提供。
预警处理状态更新时间范围的起点,格式为 yyyy-MM-dd HH:mm:ss。
outcomeUpdatedTimeEnd
条件:按预警处理状态更新时间范围筛选时提供。
预警处理状态更新时间范围的终点,格式为 yyyy-MM-dd HH:mm:ss。
billDesc
商户账单描述;可按账单描述筛选预警记录。
resellerSubMerchantId
条件:代理运营商为其子商户查询预警记录时必填;普通商户无需传入。
代理运营商的子商户标识。
outcomeList
按预警处理结果筛选,便于区分已处置与待处理的预警。
示例:
可选值
stopped
订单已停止。
partially_stopped
订单部分停止。
previously_cancelled
交易已被取消。
约束
规则
可传一个或多个状态,多个状态以英文逗号分隔。
current
查询页码,从 1 开始。
示例:
sign
请求签名字符串;生成方式详见请求签名。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/ethoca/agency-cw/detail-page' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "alertTypes": "ChargebackAlert",
  "current": "1",
  "merchantNo": "replace_with_merchant_no",
  "outcomeList": "in_progress,previously_refunded",
  "sign": "{{SIGN}}"
}'

响应

respCode
响应码;20000 表示查询请求处理成功,其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读说明。
业务数据对象,包含预警记录列表与分页信息。

响应示例

示例代码暂不可用。

该接口暂未记录错误响应。