請求簽名

确认 API 簽名

您可以在服务端對請求參數進行簽名並將其新增至請求正文。PayTo Pay將檢查簽名的有效性以確保其未被竄改。如果簽名因任何原因未通過，則請求將被丟棄。

您可以在 商戶後台商戶中心->應用管理 中找到並設定您的私鑰（FAQ）。

PassToPay 默认使用消息摘要MD5算法產生簽名。

第 1 步： 對參數進行排序並連接

• 依參數名稱的 ASCII 代碼升序對非空參數值進行排序。

• 將URL鍵值對格式的參數拼接成字串。

• 參數名稱區分大小寫。

範例：key1=value1&key2=value2&key3=value3

第2步：參數簽名

• 將 StringA 與“&key=”和私鑰連接以獲得 stringSignTemp。

• 計算 stringSignTemp 的 MD5

• 將產生的MD5值轉換為大寫以獲得簽名結果signValue。

StringA = "key1=value1&key2=value2&key3=value3"
privateKey = "your_private_key"
stringSignTemp = StringA + "&key=" + privateKey
signValue = MD5(stringSignTemp).toUpperCase()

第 3 步：在請求中添加簽名

將產生的簽名（signValue）加入到請求中的「sign」參數。

{
  "amount": 1,
  "mchOrderNo": "mho1694051705945",
  "subject": "Commodity Title",
  "wayCode": "ALI_BAR",
  "sign": "924065BA077FA461A9B06D2E76E9ED3C",
  "reqTime": "1694051706",
  "body": "Commodity Description",
  "version": "1.0",
  "channelExtra": "{"authCode":"284957415846666792"}",
  "appId": "6447428682ca7458118af79f",
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://www.jeequan.com",
  "signType": "MD5",
  "currency": "CNY",
  "mchNo": "M1682391685"
}

您可以點擊這裡取得範例程式碼，幫助您快速實現。

Java

public class SignatureGenerator {
    private static final String ENCODING_CHARSET = "UTF-8";

    public static void main(String[] args) {
        Map<String, String> parameters = new HashMap<>();
        parameters.put("key1", "value1");
        parameters.put("key2", "value2");
        parameters.put("key3", "value3");
        // Add more parameters 
        String signature = generateSignature(parameters);
        System.out.println("Generated Signature: " + signature);
    }

    public static String generateSignature(Map<String, String> parameters) {
        ArrayList<String> list = new ArrayList<>(parameters.size());
        for (Map.Entry<String, String> entry : parameters.entrySet()) {
            if (entry.getValue() != null && !entry.getValue().isEmpty()) {
                list.add(entry.getKey() + "=" + entry.getValue() + "&");
            }
        }
        list.sort(String.CASE_INSENSITIVE_ORDER);
        StringBuilder sb = new StringBuilder();
        for (String element : list) {
            sb.append(element);
        }
        String result = sb.toString();
        result += "key=" + getSecretKey();
        result = computeMD5(result, ENCODING_CHARSET).toUpperCase();
        return result;
    }

    private static String getSecretKey() {
        return "your_secret_key";
    }

    private static String computeMD5(String value, String charset) {
        try {
            byte[] data = value.getBytes(charset);
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] digestData = md.digest(data);
            StringBuilder sb = new StringBuilder();
            for (byte b : digestData) {
                int current = b & 0xff;
                if (current < 16) {
                    sb.append("0");
                }
                sb.append(Integer.toString(current, 16));
            }
            return sb.toString();
        } catch (NoSuchAlgorithmException | UnsupportedEncodingException e) {
            e.printStackTrace();
            return null;
        }
    }
}

PHP

JavaScript

Python

Go