• Ethoca 服务开通申请
  • 功能介绍
    • 预警类型
    • 处理流程
  • 申请条件
  • 接口定义
  • 请求参数
  • 响应参数
    • data
  • 请求及响应示例
  • 报备状态异步通知
  • 注意事项

Ethoca 服务开通申请

本文档介绍如何申请开通 Ethoca 卡组拒付预警服务。ETHOCA 是一个跨网络的拒付预警和欺诈防护平台，现为 Mastercard 旗下，但处理多家卡组织的拒付预警。

功能介绍

Ethoca 预警服务可以帮助商户及时获取交易相关的风险信息，包括：

• 多卡组织支持：Mastercard、American Express、Discover 等
• 部分地区支持 Visa 卡（与 RDR 形成互补）
• 全球超过 5,000 家发卡机构

预警类型

• 卡组织拒付预警
• 潜在的欺诈交易风险提示
• 持卡人争议交易预警

通过及时获取这些信息，商户可以：

• 提前识别高风险交易
• 采取相应的风险控制措施
• 降低拒付率和欺诈损失
• 提高交易安全性

处理流程

申请条件

申请条件

• 支持 Mastercard 等卡组织交易
• 满足相关合规要求
• 完成必要的商户资质审核

接口定义

POST

请求参数

名称	类型	长度	必填	签名	描述
merchantNo	String	20	Yes	Yes	商户号
preDisputeService	String	32	Yes	Yes	预警服务，固定值：ETHOCA_ALERT
billDesc	String	128	Yes	Yes	商户账单描述，将显示在持卡人银行账单上，建议使用商户实际经营名称
resellerSubMerchantId	String	20	No	Yes	代理运营商的子商户标识，当代理商为其管理的子商户申请服务时使用。同一个代理商(merchantNo)可以为多个子商户申请开通服务
notes	String	256	No	Yes	备注信息，可填写特殊需求或说明
sign	String	/	Yes	No	签名字符串，请参阅签名接口

代理商操作说明

如果您是代理运营商：

1. 使用您的 merchantNo 和签名密钥发起请求
2. 为每个子商户分配唯一的 resellerSubMerchantId
3. 在申请时，使用子商户的实际经营名称作为 billDesc
4. 每个子商户可以单独申请 Ethoca 服务，互不影响

如果您是普通商户，则无需填写 resellerSubMerchantId 字段。

响应参数

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

data

名称	签名	类型	描述
id	Yes	String	申请单号，用于后续查询申请状态
sign	No	String	签名字符串，请参阅签名接口

请求及响应示例

POST

请求参数

{
  "billDesc": "ONERWAY 400-139-8889 CN - 638443",
  "merchantNo": "800209",
  "notes": "需要开通Ethoca的拒付预警服务",
  "preDisputeService": "ETHOCA_ALERT",
  "resellerSubMerchantId": "2",
  "sign": "d905bba5340ac383770c5aefbfa469dd9a01d052c3b15a8ef6c0ee3c2a3c2ab3"
}

响应参数

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
      "id": "1907079993050398720",
      "sign": "3e41ece021eb0e6542f3fb3e5afd53fb87d4d7fbc08880ab79b00582d86f62ab"
  }
}

报备状态异步通知

Onerway审核状态变更通知

{
    "id": 1911647683383529472,
    "merchantNo": 800209,
    "preDisputeService": "ETHOCA_ALERT",
    "billDesc": "ONERWAY 400-139-8889 CN - 34336",
    "resellerSubMerchantId": "554450",
    "fromEnrollmentStatus": "SUBMITTED_AND_PENDING_ENROLLMENT",
    "enrollmentStatus": "ENROLLING",
    "notes": "Hat",
    "comments": "审批通过",
    "createOpr": "Abel",
    "createTime": "2025-04-14 13:08:19",
    "updateOpr": "admin",
    "updateTime": "2025-04-14 13:09:10",
    "sign": "47cc9b52d64b548e30653e6c51ee58b92c88cb8b25132b4973830ff80ca9ec10"
}

Ethoca审核状态变更通知

{
    "id": 1911647683383529472,
    "merchantNo": 800209,
    "preDisputeService": "ETHOCA_ALERT",
    "billDesc": "ONERWAY 400-139-8889 CN - 34336",
    "resellerSubMerchantId": "554450",
    "fromEnrollmentStatus": "ENROLLING",
    "enrollmentStatus": "ENROLLED",
    "notes": "Hat",
    "comments": "报备成功",
    "createOpr": "Abel",
    "createTime": "2025-04-14 13:08:19",
    "updateOpr": "admin",
    "updateTime": "2025-04-14 13:09:35",
    "sign": "3ccff55c3c198559f6a57c3ba357ba82fa2f0c42b34050822aa1b6ea33dd7964"
}

注意事项

注意事项

1. 申请被拒绝后，可以重新提交申请
2. 审核通过后，我们会通过邮件通知联系人开始进行服务配置
3. 请求参数需要按照签名规则进行签名