签名机制

为保证API的安全调用，平台会对每个请求和响应通过签名进行身份验证。

接入方与平台需使用签名算法SHA256withRSA，对请求待签字符串和响应待签字符串进行签名，签名结果采用Base64 编码，对应请求和响应的sign字段。

接入方会提前收到平台为您分配的2048位RSA平台公钥（Base64 编码格式），同时平台需要接入方提前提供2048位RSA商户公钥（Base64 编码格式）。

整个请求与响应流程涉及2对RSA密钥：属于平台的平台公钥与平台私钥，属于接入方的商户公钥与商户私钥。公钥用于验证签名，私钥用于生成签名。

请求待签字符串

将请求的bizContent字段json序列化。

重要：请使用未加密的bizContent内容进行签名

参与签名的BizContent原始值

{"cardCurrencyCode":"USD","settlementCurrencyCode":"USD","activeDate":"2023-01-01","inactiveDate":"2024-01-01","cardLimit":1000,"supportedMccGroup":"ecom","cardProductCode":"C02","cardType":"GWTTP","cardLabel":"MasterCard","userReferenceMap":{"useRef1Txt":"anything"}}

接入方：对请求待签字符串先使用商户私钥生成签名，再进行Base64编码。结果作为请求中sign字段的值。

平台：对收到的请求头中sign字段的值先进行Base64解码，再使用商户公钥验证签名。

响应待签字符串

重要：请先将收到的bizContent字段内容进行解密

平台：对响应待签字符串先使用平台私钥生成签名，再进行Base64编码。结果作为响应中sign字段的值。

接入方：对收到的响应中sign字段的值先进行Base64解码，再使用平台公钥验证签名。

工具类示例

PHP

<?php

class RsaUtils {

    public static function rsaSign(string $privateKeyStr, string $content): string {
        openssl_sign($content, $signature, self::pemFormat($privateKeyStr, 'RSA PRIVATE KEY'), OPENSSL_ALGO_SHA256);
        return base64_encode($signature);
    }

    public static function rsaVerify(string $publicKeyStr, string $content, string $signature): bool {
        return openssl_verify($content, base64_decode($signature), self::pemFormat($publicKeyStr, 'PUBLIC KEY'), OPENSSL_ALGO_SHA256) === 1;
    }

    private static function pemFormat(string $keyStr, string $label): string {
        return "-----BEGIN {$label}-----\n" . chunk_split($keyStr, 64) . "-----END {$label}-----\n";
    }
}

Java