企业官网建设流程全解析

如何快速接入支付宝支付？alipay_sdk_cj仓颉原生SDK完全指南

【免费下载链接】alipay_sdk_cjAliPay Sdk for 仓颉 支付宝接口后端sdk，方便cangjie开发者快速接入支付宝的支付接口（目前只支持最广泛使用的商户直接接入模式，只支持最安全的RSA2，公钥证书方式签名验证方式,默认只支持utf-8编码和JSON格式）项目地址: https://gitcode.com/Cangjie-SIG/alipay_sdk_cj

alipay_sdk_cj是专为仓颉（Cangjie）语言打造的支付宝支付后端原生 SDK，帮助开发者以最低成本接入支付宝全场景支付能力。它内置 RSA2 签名/验签、公钥证书安全校验、商户直接接入模式，开箱即用，无需手写签名逻辑。

🎯 核心特性一览

在开始之前，先了解它能为你的仓颉项目做什么：

⚠️ 目前仅支持商户直接接入模式，暂不支持间连模式。

📦 一键安装：在仓颉项目中引入依赖

接入 alipay_sdk_cj 只需两步：

第 1 步：配置环境变量

项目依赖stdx扩展包（LTS 1.0.0 起标准库拆分）。请先下载 stdx 包，并在系统中设置CANGJIE_STDX_HOME环境变量：

# Linux / macOS（写入 ~/.bash_profile 或 ~/.zshrc） export CANGJIE_STDX_HOME=/your/path/to/cangjie_stdx

第 2 步：添加 cjpm 依赖

在你的项目 cjpm.toml 的[dependencies]区块中，添加alipay_sdk的 git 依赖：

[dependencies] alipay_sdk = {git = ".../alipay_sdk_cj.git", branch = "main"}

• LTS 1.0.0 通道：使用main分支
• Beta 0.53.13 通道：使用beta_0.53.13分支

完整配置可参考 example/cjpm.toml。

🔑 构建支付客户端：5 分钟搞定密钥配置

alipay_sdk_cj 采用Builder 模式构建客户端，核心配置项如下：

💡密钥格式提示：RSA2 密钥必须使用PKCS1格式（非 Java 适用），通过 CSR 文件向支付宝申请生成。密钥以单行 Base64 字符串传入即可，SDK 内部会自动格式化为 PEM（见 src/sign.cj）。

沙箱环境与生产环境使用不同的网关地址和证书。开发调试阶段建议使用支付宝新版沙箱环境（网关地址以openapi-sandbox开头），上线前切换为正式配置。

💳 支持的支付接口全表

SDK 已覆盖商户日常经营所需的全部核心交易接口：

📌tradeAppPay、tradeWapPay、tradePagePay三个接口后端只生成签名后的 form 表单数据，由前端页面提交给支付宝完成跳转支付。

所有接口的请求参数类定义在 src/biz/ 目录下，对应的响应结构体在 src/response/ 中。

🚀 发起一笔交易：从下单到验签

下面用最精简的方式说明一笔tradeCreate调用的完整流程（参考 example/src/main.cj）：

① 构造业务参数

创建对应的Biz对象并填充字段，例如商品名称、商户订单号、金额等：

var bizContent = biz.TradeCreateBiz() bizContent.setSubject(JsonString("华为Mate70")) bizContent.setOutTradeNo(JsonString(outTradeNo)) bizContent.setTotalAmount(JsonInt(5))

② 发起请求

调用客户端方法即可，SDK 内部自动完成签名、HTTP 请求、同步验签、响应反序列化：

let client = newPayClient() // 构建 PayClient（见上文配置） let result = client.tradeCreate(bizContent) println(result.serialize().toJson())

③ 响应结构

每个接口都有对应的强类型响应类（如TradeCreateResponse），包含code、msg、sub_code、sub_msg、trade_no等字段，直接访问即可，无需手动解析 JSON。

🔒安全机制：每次接口调用返回后，SDK 会自动用支付宝公钥对响应数据进行 RSA2 同步验签（实现在 src/pay.cj 的doAlipay方法中）。验签失败会直接抛出异常，防止中间人篡改。

📡 异步回调验签：接收支付宝通知

支付宝支付成功后会通过 POST 请求通知你的服务器。SDK 提供了asyncVerifySign方法完成验签：

isPass = newPayClient().asyncVerifySign(body) // body 为回调原始字节 if (isPass) { // 验签通过 → 更新订单状态 → 返回 "success" ctx.responseBuilder.status(200).body("success") } else { // 验签失败 → 返回 "fail" ctx.responseBuilder.status(200).body("fail") }

⚠️关键细节：验签通过后必须返回字符串success，否则支付宝会多次重发回调，造成重复处理。

📂 源码结构速览

alipay_sdk_cj/ ├── cjpm.toml # 项目配置与多平台 stdx 依赖 ├── config # cjdoc 文档生成配置 ├── example/ # 可运行的示例代码 │ └── src/main.cj # tradeCreate 完整示例 └── src/ ├── pay.cj # PayClient / PayClientBuilder / Payer 接口 ├── sign.cj # RSA2 签名与验签（SignSHA256WithRSA） ├── request.cj # 请求参数组装与编码 ├── util.cj # 通用工具函数 ├── biz/ # 各接口请求参数类（TradeCreateBiz 等） ├── response/ # 各接口响应结构体 └── jsonhelper/ # JSON 序列化辅助函数

核心入口是 src/pay.cj 中定义的Payer接口和PayClient实现，签名逻辑封装在 src/sign.cj 的SignSHA256WithRSA结构中。

🛠️ 生成 API 文档

项目内置了cjdoc文档生成能力。在仓库根目录执行：

cd alipay_sdk_cj cjdoc config

生成的 HTML 文档位于apidocs/docs/目录下，用浏览器打开index.html即可浏览完整的 API 参考。

⚡ 常见注意事项

总结

alipay_sdk_cj 将支付宝支付最复杂的签名、验签、证书校验全部封装进 SDK，仓颉开发者只需关注业务参数填充和订单状态处理两件事，即可安全地接入支付宝全场景支付。从添加依赖到跑通第一笔沙箱交易，通常 10 分钟内即可完成 🎉

【免费下载链接】alipay_sdk_cjAliPay Sdk for 仓颉 支付宝接口后端sdk，方便cangjie开发者快速接入支付宝的支付接口（目前只支持最广泛使用的商户直接接入模式，只支持最安全的RSA2，公钥证书方式签名验证方式,默认只支持utf-8编码和JSON格式）项目地址: https://gitcode.com/Cangjie-SIG/alipay_sdk_cj