验签网关

POST

/sop/gateway

签名规则

第一步，筛选并排序

获取所有请求参数，不包括字节类型参数，如文件、字节流，剔除sign字段，剔除值为空的参数，并按照第一个字符的键值ASCII码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值ASCII码递增排序，以此类推。

第二步，拼接参数

将排序后的参数与其对应值，组合成“参数=参数值”的格式，并且把这些参数用&字符连接起来，此时生成的字符串为待签名字符串。

第三步，调用签名函数

使用各自语言对应的SHA256WithRSA(对应sign_type为RSA2)签名函数利用商户私钥对待签字符串进行签名，并进行Base64编码。

第四步，签名赋值

把生成的签名赋值给sign参数，拼接到请求参数中（参照SDK中的util方法）。

请求参数

Body 参数application/x-www-form-urlencoded

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/sop/gateway' \
--data-urlencode 'app_id=102508042' \
--data-urlencode 'merchant_request_no=106ed39e00e5482095bc012b83678dc2' \
--data-urlencode 'method=person.income.tax.query' \
--data-urlencode 'biz_content=' \
--data-urlencode 'sign_type=RSA2' \
--data-urlencode 'timestamp=2025-11-20 18:06:16' \
--data-urlencode 'version=1.0' \
--data-urlencode 'sign='

返回响应

🟢200成功

application/json

Body

示例

{
    "app_id": "string",
    "merchantRequestNo": "string",
    "timestamp": "string",
    "response": "string",
    "code": "10000",
    "msg": "string",
    "subCode": "string",
    "subMsg": "string"
}

修改于 2025-12-02 06:28:39

SDK下载地址

回调通知

验签网关

签名规则#

第一步，筛选并排序#

第二步，拼接参数#

第三步，调用签名函数#

第四步，签名赋值#