• Ethoca 预警处理
  • 功能说明
    • 处理流程
  • Ethoca 预警通知
  • 接口定义
  • 请求参数
  • 响应参数
    • data
  • 请求及响应示例
  • 注意事项

Ethoca 预警处理

本文档介绍如何处理 Ethoca 预警信息。通过该接口，您可以更新预警的处理状态，包括处理结果和退款状态等信息。

功能说明

预警处理接口允许商户：

• 更新预警的处理状态
• 标记预警的退款状态
• 跟踪预警的处理进度
• 反馈处理结果给发卡行

处理流程

Ethoca 预警通知

{
    "id": 1911669431696592897,
    "merchantNo": 800209,
    "ethocaId": "sqhWZvoaIcRUVNCWHrbx8",
    "alertType": "CustomerDispute",
    "alertTime": "2025-04-14 14:26:21",
    "alertAge": 0,
    "txnTime": "2025-04-14 13:26:21",
    "txnAmount": 1.000000,
    "txnCurrency": "USD",
    "resellerSubMerchantId": "965566",
    "billDesc": "ONERWAY 400-139-8889 CN 77465",
    "arn": "800209-124",
    "submitOutcomeStatus": "PENDING_OUTCOME",
    "outcome": null,
    "outcomeUpdatedTime": null,
    "refundStatus": null,
    "createOpr": "Abel",
    "createTime": "2025-04-14 14:34:44",
    "updateOpr": "Abel",
    "updateTime": "2025-04-14 14:34:44",
    "issuer": "CARD_ISSUER",
    "cardNumber": "4000000000002701",
    "ethocaMerchantId": "414618",
    "mcc": "5629",
    "transactionType": "eCommerce",
    "initiatedBy": "diners_club",
    "liability": "no",
    "authCode": "111047",
    "integratorMemberId": "75529958",
    "transactionId": "1909067241308422144",
    "chargebackReasonCode": "10",
    "chargebackAmount": 1,
    "chargebackCurrency": "USD"
}

接口定义

POST

请求参数

名称	类型	长度	必填	签名	描述
merchantNo	String	20	Yes	Yes	商户编号，用于标识商户身份
ethocaId	String	64	Yes	Yes	Ethoca 预警唯一标识
outcome	String	32	Yes	Yes	处理结果： stopped - 订单已停止 partially_stopped - 订单部分停止 previously_cancelled - 交易已被取消 missed - 已过期（订单已发货或服务已消费） notfound - 未找到相关订单 account_suspended - 账户已被暂停 in_progress - 正在处理该请求 shipper_contacted - 已联系发货方并尝试拦截货物 other - 其他未列出的情况 resolved - 已解决 previously_refunded - 已退款 unresolved_dispute - 未解决的争议
refundStatus	String	32	Yes	Yes	退款状态： refunded - 已完成退款 not refunded - 未进行退款 not settled - 退款处理中
sign	String	/	Yes	No	请求签名，详见签名说明

响应参数

名称	类型	描述
respCode	String	来自 Onerway 的响应码
respMsg	String	来自 Onerway 的响应信息
data	Object	响应数据。 请参阅对象 data

data

名称	签名	类型	描述
success	Yes	Boolean	处理结果是否成功
sign	No	String	响应签名，详见签名说明

请求及响应示例

POST

请求参数

{
  "ethocaId": "nIlSfB1HCC-wDyC93-8a8",
  "merchantNo": "800209",
  "outcome": "resolved",
  "refundStatus": "refunded",
  "sign": "41565f0e49edbde6442f3f5e5b4c9a7bf891501b1e08f6a720d3aa809b50c97d"
}

响应示例

{
    "respCode": "20000",
    "respMsg": "Success",
    "data": {
        "success": true,
        "sign": "899988f6f4fff6e522eedbadd8aa4bdad15c96c283d8ef86af5f5cc7bb9d0963"
    }
}

注意事项

注意事项

1. 预警处理状态一旦更新，将无法撤销
2. 请确保提交准确的处理结果和退款状态
3. 处理结果将实时同步给发卡行
4. 请求参数需要按照签名规则进行签名

最佳实践

1. 及时处理收到的预警信息
2. 准确选择合适的处理结果状态
3. 如果进行了退款操作，确保更新正确的退款状态
4. 保存预警处理记录，便于后续跟踪