POST
查询 Ethoca 预警
该接口用于查询 Ethoca 预警记录,将预警匹配回原交易,并查看最新处理结果和退款状态。
请求
merchantNoOnerway 分配的商户号;用于限定查询的商户账户范围。
示例:
replace_with_merchant_noethocaIdEthoca 预警唯一标识;传入后可按单条预警精确查询。
示例:
replace_with_ethoca_idalertTypes按预警类型筛选;不同类型对应客户争议、欺诈或拒付等风险来源。
示例:
ChargebackAlert可选值
CustomerDispute- 客户争议预警。
FraudAlert- 欺诈预警。
ChargebackAlert- 拒付预警。
alertTimeStart条件:按预警生成时间范围筛选时提供。
预警生成时间范围的起点,格式为 yyyy-MM-dd HH:mm:ss。示例:
2025-02-02 13:22:26alertTimeEnd条件:按预警生成时间范围筛选时提供。
预警生成时间范围的终点,格式为 yyyy-MM-dd HH:mm:ss。示例:
2025-04-03 13:22:26txnTimeStart条件:按原交易时间范围筛选时提供。
原交易时间范围的起点,格式为 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按预警处理结果筛选,便于区分已处置与待处理的预警。
示例:
in_progress,previously_refunded可选值
stopped- 订单已停止。
partially_stopped- 订单部分停止。
previously_cancelled- 交易已被取消。
约束
- 规则
- 可传一个或多个状态,多个状态以英文逗号分隔。
current查询页码,从
1 开始。示例:
1sign请求签名字符串;生成方式详见请求签名。
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响应码对应的可读说明。
data{ content, current, ... }业务数据对象,包含预警记录列表与分页信息。
响应示例
示例代码暂不可用。
该接口暂未记录错误响应。