开始接入

快速掌握Checus支付接口集成与调试方法

接入流程

步骤1 . 创建测试账户

访问 Checus开发者中心 ，使用邮箱创建测试账户。

您可以在开发者中心中使用如下服务：

• 设置测试商户：获取商户号、AppID、公私钥。
• 使用开发者工具：RSA密钥生成工具、RSA签名工具。
• 进行测试：查看请求示例、发起测试交易。

在申请正式账户前，建议先和您的商务顾问确认，确保不在合作限制名单中以便顺利接入 Checus。

步骤2 . 设置测试环境

1. 获取测试商户信息

您可进入'基础设置'> '开发信息'> '密钥信息'中获取 测试商户号、App Id，为接口请求的必传信息，可参考如下请求示例。

  curl --request POST \
  --url https://p-gate-uat.checus.com/aggregate-pay/api/gateway/orderAndPay \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'sign: FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A==' \
  --data '{
    "version": "1.4",
    "keyVersion": "1",
    "requestTime": "2025-05-14T06:29:50.085+00:00",
    "appId": "<您的appId>",
    "merchantNo": "<您的merchantNo>",
    "data": <请求数据JSON>
}'

2. 配置测试密钥信息

密钥使用机制

使用的签名算法

类型	说明
加密算法	RSA
密钥格式	PKCS#8
签名算法	SHA256WithRSA
密钥长度	2048 bits

密钥生成方式

Checus使用非对称密钥及SHA256WithRSA算法对报文进行加签验签，您可以选择以下任一方式生成公私钥对。

生成密钥后，进入'基础设置'> '开发信息'> '密钥信息'，选择 公钥上传 ，可查看平台公钥及上传您的公钥。请妥善保管密钥信息，如有泄露风险请及时登录开发者中心更新。

方式1. 通过开发者平台生成密钥

登入 开发者平台，'开发者工具' > 'RSA密钥生成'，生成密钥对。

方式2. 通过OpenSSL命令行生成密钥

1. 安装 OpenSSL 工具，可前往 https://www.openssl.org/source/ 下载；
2. 执行以下命令生成密钥对（格式为 PKCS8）：

# 生成私钥（PKCS8格式）
openssl genrsa 2048 | openssl pkcs8 -topk8 -nocrypt -out private.key.pem
# 生成公钥
openssl rsa -in private.key.pem -pubout > public.key.pem

生成后的文件内容示例如下：

• 公钥（public.key.pem）：

-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...
-----END PUBLIC KEY-----

• 私钥（private.key.pem）：

-----BEGIN PRIVATE KEY-----
MIIEwAIBADANBgkqhkiG9w0BAQEFAA...
-----END PRIVATE KEY-----

平台上传或使用密钥时，请手动去除开头、结尾标记和换行符，仅保留纯粹的字符串内容。

示例：处理后的密钥字符串

• 公钥字符串：

  MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzN6tx98b4KZB1uqEuT7P/nWHrYqFdiy+Kzs9KZ6...

• 私钥字符串：

  MIIEwAIBADANBgkqhkiG9w0BAQEFAASCBKowggSmAgEAAoIBAQDM3q3H3xvgpkHW6oS5Ps/+dYetioV2L...

报文加签说明

签名前的原始报文内容必须与 HTTP请求体中的字符串内容完全一致，否则将导致验签失败。
例如以下两个报文虽然语义一致，但因格式化不同，导致加签结果不一致：

• 格式化 JSON：

  {
    "key1": "val1",
    "key2": "val2",
    "key3": "val3"
  }
  
  使用示例私钥加签结果：
  "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPU..."

• 压缩 JSON：

  {"key1":"val1","key2":"val2","key3":"val3"}
  
  使用示例私钥加签结果：
  "W/unZQUH9366PZDhYlCghA7q66VmPDBN/7OvVKhigQNfLJPxGnbhrH6JV4rYlsyfd..."

3. 配置测试回调地址

请进入'基础设置' > '开发信息' > '通知地址'，设置接收支付、退款等异步通知地址。

4. 配置服务器IP白名单

若您的测试环境启用了IP访问控制，请联系 Checus 技术支持获取服务器回调 IP，并将其加入您的白名单。否则，Checus 发送的回调通知可能无法成功送达。

5. 开通测试环境的支付方式

在 '基础设置' > '支付方式管理' 页面，开通或关闭您账户下可使用的支付方式。

步骤3. 集成所需产品

在线收单

收银台支付

用户跳转收银台完成订单支付

API支付

通过接口直接调用发起支付请求

前置组件支付

集成支付组件,页面内快速完成支付

链接支付

生成支付链接,用户点击完成付款

订阅支付

周期收取用户费用

在线出款

商户管理平台出款

商户后台手动操作发起资金出款

API出款

通过接口自动提交资金出款请求

步骤4. 测试与验收

登录开发者中心，'基础设置' > '支付方式管理'，确认所需支付方式已开通。

• 连通性测试：您可构建一个简单请求确认加验签、IP 白名单等配置正确；

• 功能性测试：在测试环境中发起一笔成功单和一笔失败单，确认接口响应；

• 集成验收：联系技术支持。

  

步骤5. 正式上线

1. 激活账号

在完成一系列KYC审核及商务流程后，Checus将为您创建 商户管理平台 管理员账号，请查收激活邮件并完成账密设置。

2. 获取商户号并配置集成参数

进入'设置服务' > '开发参数' > '正式环境'中查看与配置如下参数：

• 商户管理：获取商户号与 AppId
• 密钥管理：配置正式环境密钥
• 地址管理：设置回调地址

如有 IP 白名单限制，请联系 Checus 获取服务器 IP；如接入付款产品，也需提供您的出口 IP。

3. 开通支付方式

部分支付方式需报备审核，通过后方可使用，进入 '设置服务' > '支付方式可用性' 查看支付方式状态。

---

在您完成上述步骤后，即可准备接受付款。