签名

请求需附带签名发送至BlockATM服务器。每个请求必须在BlockATM-API-Key请求头中包含api-key，以便BlockATM验证请求确实由您的服务器发出，而非第三方。

Basic Information

• ApiKey 对接公钥，需包含在每个请求的 BlockATM-API-Key 请求头中

• Secret Key 对接密钥，用于加密请求参数，生成的签名结果需放入 BlockATM-Signature-V2 请求头

您可以在商户后台的不同集成场景下（如收银台或付币合约）对接页面找到对应的API密钥。

Sign

步骤 1;

将JSON对象中的所有参数按照键的ASCII字符顺序升序排列，并以"key=value"的格式用"&"符号连接。

请求原始参数：

{"custNo":"86000123","orderNo":"202504001399","lang":"zh-CN"}

处理结果：

custNo=86000123&lang=zh-CN&orderNo=202504001399

步骤 2

将请求头中的 'BlockATM-Request-Time' 以 '&time=' 格式拼接到字符串末尾。

假设 BlockATM-Request-Time = 1742723373000

处理结果:

custNo=86000123&lang=zh-CN&orderNo=202504001399&time=1742723373000

步骤 3

使用SHA-256哈希函数计算HMAC签名，并以您的收银台密钥(Secret Key)作为加密密钥。

Dihl6oOt5UkaHo9sEouquP3EqbukLX2dAOoKTSGicYryTvH1m9r6vtSLHGutZn7u34/06gjhdpbXRFPdjb51GVHvG75qWXZ1P/boL89xtuja6eTEy9q/aS8R270Q1A+m/MOTxdiifCy0IByrSpCs4VJKaj2d8jlJo2GHznsH+q0=

您可以根据开发语言参考以下示例：

java

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.*;

public class BlockATMSigner {
    
    // 配置参数（实际使用应从安全存储获取）
    private static final String API_KEY = "your_api_key_here";
    private static final String SECRET_KEY = "your_secret_key_here";
    private static final long REQUEST_TIME = 1742723373000L; // 示例时间戳

    public static void main(String[] args) {
        try {
            // 1. 准备请求参数
            Map<String, String> params = new HashMap<>();
            params.put("amount", "44");
            params.put("bizOrderNo", "B234569885XASA953ASDSAD");
            params.put("chainId", "11155111");
            params.put("custNo", "473_860001");
            params.put("merchantId", "286000260");
            params.put("symbol", "USDT");
            params.put("toAddress", "0xc87dd49427a188bf2b601c1d5cd2aaf36bd553d2");
            params.put("remark", "demo for create payout order");

            // 2. 生成签名
            String signature = generateSignature(params, REQUEST_TIME);

            // 3. 构建请求头
            Map<String, String> headers = new HashMap<>();
            headers.put("BlockATM-API-Key", API_KEY);
            headers.put("BlockATM-Signature-V2", signature);
            headers.put("BlockATM-Request-Time", String.valueOf(REQUEST_TIME));

            // 输出结果
            System.out.println("Request Headers:");
            headers.forEach((k, v) -> System.out.println(k + ": " + v));

        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    /**
     * 生成HMAC-SHA256签名
     */
    private static String generateSignature(Map<String, String> params, long timestamp) 
        throws NoSuchAlgorithmException, InvalidKeyException {
        
        // 步骤1：排序并拼接参数
        String sortedParams = getSortedParams(params);
        
        // 步骤2：拼接时间戳
        String payload = sortedParams + "&time=" + timestamp;
        
        // 步骤3：计算HMAC
        Mac sha256Hmac = Mac.getInstance("HmacSHA256");
        SecretKeySpec secretKey = new SecretKeySpec(
            SECRET_KEY.getBytes(StandardCharsets.UTF_8), 
            "HmacSHA256"
        );
        sha256Hmac.init(secretKey);
        byte[] hash = sha256Hmac.doFinal(payload.getBytes(StandardCharsets.UTF_8));
        
        return bytesToHex(hash);
    }

    /**
     * 按ASCII顺序排序参数
     */
    private static String getSortedParams(Map<String, String> params) {
        // 使用TreeMap自动排序
        Map<String, String> sortedMap = new TreeMap<>(params);
        
        // 拼接键值对
        List<String> paramList = new ArrayList<>();
        for (Map.Entry<String, String> entry : sortedMap.entrySet()) {
            paramList.add(entry.getKey() + "=" + entry.getValue());
        }
        return String.join("&", paramList);
    }

    /**
     * 字节数组转十六进制
     */
    private static String bytesToHex(byte[] bytes) {
        StringBuilder result = new StringBuilder();
        for (byte b : bytes) {
            result.append(String.format("%02x", b));
        }
        return result.toString();
    }
}

python

PHP

C++

Go