1. 预警的拒付拦截效率
• Ethoca预警覆盖：M卡80% ；V卡20-30%；小卡种50%
• RDR预警覆盖：95%的VISA卡预警 (剩余5%原因是部分小众发卡行未完全覆盖以及卡组系统抖动）

2. 支持同时开通两种服务，但存在一定比例的重复计费
• Ethoca和RDR预警同时开通后，约有10-15%的重复率

3. ETHOCA预警和RDR预警的区别
• 覆盖面不同：Ethoca预警包含了Mastercard卡、VISA卡和部分小卡种，合作发卡行在5000家以上；RDR预警覆盖VISA卡，合作发卡行在1000家左右
• 退款处理方式不同：Ethoca预警，商户需要自行在收单平台自行做退款处理，RDR预警可以实现自动退款，商家无需自行处理退款

4. 商户注册预警服务流程
1. 商户登录跨拒通后台提交注册商户信息，ethoca需要提供descriptor,RDR需要提供descriptor、BIN、CAID、ARN（非必填但非常建议报送，用于卡组更快定位商户，缩短注册时间）。
2. 请注意：如果您在上一家服务商已经使用了目前的商户号，请在上一家服务商完成商户退出后，跨拒通才能够向卡组注册成功。
3. 跨拒通需要2-5天时间向卡组报备商户，报备完成后。跨拒通将通过系统和邮件通知商家报备成功，并开始向商家发送预警数据
4. 商家可以通过接口或者通过跨拒通系统查看和反馈预警数据。ethoca预警需要商家反馈退款状态；RDR则直接自动执行退款无需商家操作
5. 跨拒通将在发送预警时按笔计费
关于商户报送信息的解释和获取方式如下：

报送字段	字段解释	如何获取
Descriptor	Descriptor 是信用卡交易中客户账单上显示的描述信息，通常用于帮助客户识别这笔交易是从哪个商户发起的。	• 由支付服务商、PF 或商户在接入收单时设置 • 在对账单上能看到这个字段（也叫 "statement descriptor"） • 也可在清算报文或交易响应中看到
BIN	BIN 是银行卡前 6 或 8 位号码，用于识别收单机构，有时一个收单方有多个 BIN（代表不同产品/服务线）。示例：430123 是某家银行的BIN，代表该该支付机构的商户通道	• 向你的收单银行、支付网关或 PF 申请 • VISA PF 或收单方分配并备案在系统中
CAID	CAID 是 Card Acceptor ID，即“商户识别号”或“终端商户编号”，由收单银行或支付机构分配，用于在VISA网络中唯一标识一个商户实体。示例：123456789012345（长度通常为15位），某跨境电商的CAID：810000112233445	• 由收单银行或第三方支付公司为每个商户分配 • 可通过商户的收单协议、商户管理平台（如VISA Portal、CyberSource、Adyen、Worldpay等）查看 • 在交易报文或清算报文中也会包含CAID字段
ARN	ARN 全称是 Acquirer Reference Number，即收单方参考号。 它是 VISA 系统为每一笔交易生成的唯一编号，用于在整个清算网络中追踪和识别该笔交易，无论是原始支付、退款、还是争议处理（包括RDR）。 特点是全球唯一，由 VISA 生成。用于追踪交易的生命周期（授权 → 清算 → 拒付 → RDR → 退款）。支付机构、收单银行、商户、VISA、发卡银行均可用其检索交易。 示例 12345678901234567890123 74843812345678901234567（常见为 23~24 位的纯数字）	• 收单银行/支付机构 在交易清算完成后，收单方会生成并分配ARN，通常可在后台系统或清算对账单中获取。 • 商户平台/服务商系统 例如 Stripe、Adyen、PayPal、Worldpay 等支持通过API或后台查看ARN。 • 交易凭证/报文在清算报文（如 TC33 或 VisaNet settlement file）中查看 ARN 字段。

5. Ethoca预警的交易匹配规则
目前Ethoca预警会存在约15%无法匹配交易的情况，这是由Ethoca机构本身造成的，并非跨拒通原因。建议商家接收到Ethoca预警后使用以下方式匹配交易：

优先级	匹配字段组合	匹配规则/注意事项
第一优先级	收单行参考编号	这是最精准的匹配方式。如果预警信息中提供了ARN，应优先使用此组合进行匹配。
第二优先级	卡号 + 交易金额 + 交易日期	如果没有ARN，搜索满足以下条件的：  1. 卡号前六位和后四位一致 2. 金额完全一致。  3. 日期必须完全一致。
第三优先级	卡号 + 交易金额 (近似) + 交易日期 (近似)	如果仍然找不到结果时，可以放宽条件，搜索满足以下条件的： 1. 卡号前六位和后四位一致 2. 金额允许有小范围的浮动（例如 ±1-2%），因为可能存在货币转换差异。 3. 交易日期：前后 ±2天）。

• 通讯方式：https + JSON

• 字符集: UTF-8

• 加密方式: MD5 Salt

• 开始使用 API时，在请求 Header中设置以下属性

• Content Type application/json

• 生产环境：https://mer.tradefensor.com

• 加密：MD5

• 参与签名的参数按照ASCII码从小到大排序，将参数按固定顺序组装成签名原始串以“&”拼接,最后在拼接上商户密钥。签名的参数顺序和格式如下：key1=value1&key2=value2...keyn=valuen*****）

java
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import org.apache.commons.lang3.StringUtils;
import org.apache.http.HttpException;

import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.*;

public class TestSign {

    public static String sign(Map<String, Object> paramValues, String secret) {
        StringBuilder sb = new StringBuilder();
        List<String> paramNames = new ArrayList<String>(paramValues.size());
        paramNames.addAll(paramValues.keySet());
        Collections.sort(paramNames);
        for (String key : paramNames) {
            Object value = paramValues.get(key);
            if (value == null || StringUtils.isBlank(value.toString())) {
                continue;
            }
            String value_inner = value.toString();
            if (value_inner.startsWith("[")) {
                sb.append("&").append(key).append("=").append(parseJsonArray(value_inner));
            } else if (value_inner.startsWith("{")) {
                Map requestMap = JSON.parseObject(value_inner);
                sb.append("&").append(key).append("=").append(sign(requestMap, secret));
            } else {
                sb.append("&").append(key).append("=").append(value.toString());
            }
        }
        sb.append("&").append(secret);
        String str = sb.substring(1,sb.length());


        return disguiseMD5(str,"UTF-8");
    }

    private static JSONArray parseJsonArray(String jsonArrayString) {
        List<Map<String, Object>> list = (List<Map<String, Object>>) JSONArray.parse(jsonArrayString);

        List<JSONObject> result = new LinkedList<JSONObject>();
        for (Map<String, Object> map : list) {
            List<String> paramNames = new ArrayList<String>(map.size());
            paramNames.addAll(map.keySet());
            Collections.sort(paramNames);

            //JSONObject.toJSONString(json, SerializerFeature.SortField)
            JSONObject jsonObject = new JSONObject(true);
            for (String key : paramNames) {
                Object value = map.get(key);
                if (value == null || StringUtils.isBlank(value.toString())) {
                    continue;
                }

                jsonObject.put(key, value);
            }

            result.add(jsonObject);
        }
//        logger.info("\nJSONArray 内JSONObject排序：{}\n", result);

        Collections.sort(result, (JSONObject o1, JSONObject o2) -> {
            Integer o1_index = o1.getInteger("index");
            Integer o2_index = o2.getInteger("index");

            if (o1_index == null || o2_index == null) {
                throw new IllegalArgumentException("参数明细中需要指定INDEX");
            }

            return o1_index.compareTo(o2_index);
        });

//        logger.info("\nJSONArray 排序：{}\n", result.toString());
        JSONArray jsonArray = new JSONArray();
        for (JSONObject jsonObject : result) {
            jsonArray.add(jsonObject);
        }
        return jsonArray;
    }

    public static String disguiseMD5(String message, String encoding) {

        if (null == message
                || null == encoding) {

            return null;
        }

        message = message.trim();
        byte value[];
        try {
            value = message.getBytes(encoding);
        } catch (UnsupportedEncodingException e) {
            value = message.getBytes();
        }
        MessageDigest md = null;
        try {
            md = MessageDigest.getInstance("MD5");
        } catch (NoSuchAlgorithmException e) {
            return null;
        }
        return toHex(md.digest(value));
    }

    public static String toHex(byte input[]) {
        if (input == null) {
            return null;
        }
        StringBuffer output = new StringBuffer(input.length * 2);
        for (int i = 0; i < input.length; i++) {
            int current = input[i] & 0xff;
            if (current < 16) {
                output.append("0");
            }
            output.append(Integer.toString(current, 16));
        }

        return output.toString();
    }

    public static void main(String[] args) throws IOException, HttpException {
        Map<String, Object> paramValues = new HashMap<>();
        paramValues.put("test","222");
        System.out.println(sign(paramValues,"Hr2JXE5mHjUL3vopraYZrZWDzfMaA0OLAvs5QxsIdJc="));
    }

}

• 协助我们的新合作伙伴进行 API 集成、开发和测试的清单。

Path: /rest/third/predictor/merchant/outcome

Path： /rest/third/predictor/merchant/alert/add

Path： /rest/third/predictor/merchant/alert/close

• 如果您在API集成过程中有任何疑问，请通过以下方式联系我们 support@tradefensor.com.