ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

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

如何快速接入支付宝支付?alipay_sdk_cj仓颉原生SDK完全指南 如何快速接入支付宝支付alipay_sdk_cj仓颉原生SDK完全指南【免费下载链接】alipay_sdk_cjAliPay Sdk for 仓颉 支付宝接口后端sdk方便cangjie开发者快速接入支付宝的支付接口目前只支持最广泛使用的商户直接接入模式只支持最安全的RSA2公钥证书方式签名验证方式,默认只支持utf-8编码和JSON格式项目地址: https://gitcode.com/Cangjie-SIG/alipay_sdk_cjalipay_sdk_cj是专为仓颉Cangjie语言打造的支付宝支付后端原生 SDK帮助开发者以最低成本接入支付宝全场景支付能力。它内置 RSA2 签名/验签、公钥证书安全校验、商户直接接入模式开箱即用无需手写签名逻辑。 核心特性一览在开始之前先了解它能为你的仓颉项目做什么特性说明 RSA2 公钥证书签名只支持最安全的 RSA2 公钥证书验证方式 手机网站支付支持alipay.trade.wap.pay接口 电脑网站支付支持alipay.trade.page.pay接口 同步/异步验签响应数据同步验签 回调异步验签asyncVerifySign JSON / UTF-8默认使用 JSON 格式和 UTF-8 编码⚠️ 目前仅支持商户直接接入模式暂不支持间连模式。 一键安装在仓颉项目中引入依赖接入 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 模式构建客户端核心配置项如下配置项来源必填setAppID支付宝开放平台分配的应用 ID✅setApiUrl网关地址沙箱/正式✅setPrivateKey商户 RSA 私钥单行 Base64✅setPublicKey商户 RSA 公钥单行 Base64✅setAlipayPublicKey支付宝公钥从证书解析✅setAppCertSn应用公钥证书序列号✅setAlipayRootCertSn支付宝根证书序列号✅setSignType固定填RSA2✅setFormat固定填JSON✅setCharset固定填utf-8✅setVersion固定填1.0✅密钥格式提示RSA2 密钥必须使用PKCS1格式非 Java 适用通过 CSR 文件向支付宝申请生成。密钥以单行 Base64 字符串传入即可SDK 内部会自动格式化为 PEM见 src/sign.cj。沙箱环境与生产环境使用不同的网关地址和证书。开发调试阶段建议使用支付宝新版沙箱环境网关地址以openapi-sandbox开头上线前切换为正式配置。 支持的支付接口全表SDK 已覆盖商户日常经营所需的全部核心交易接口接口说明返回值tradeCreate统一收单交易创建结构化响应tradePay统一收单交易支付结构化响应tradeQuery统一收单交易查询结构化响应tradeAppPayApp 支付 2.0表单数据前端调用tradeWapPay手机网站支付 2.0表单数据前端调用tradePagePay电脑网站支付表单数据前端调用tradeCancel交易撤销结构化响应tradeRefund交易退款结构化响应tradePageRefund退款页面结构化响应tradeFastpayRefundQuery退款查询结构化响应tradeClose交易关闭结构化响应asyncVerifySign异步回调验签BooltradeAppPay、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 参考。⚡ 常见注意事项问题解决方案找不到 stdx 包确认已设置CANGJIE_STDX_HOME环境变量指向 stdx 静态库路径验签总是失败检查密钥格式是否为PKCS1非 PKCS8支付宝公钥是否正确沙箱调不通确认网关地址是新版沙箱openapi-sandbox.dl.alipaydev.com回调重复通知验签通过后务必返回success且做好幂等处理想添加新接口在 src/biz/ 下新增 Biz 类在 src/pay.cj 中补充调用方法总结alipay_sdk_cj 将支付宝支付最复杂的签名、验签、证书校验全部封装进 SDK仓颉开发者只需关注业务参数填充和订单状态处理两件事即可安全地接入支付宝全场景支付。从添加依赖到跑通第一笔沙箱交易通常 10 分钟内即可完成 【免费下载链接】alipay_sdk_cjAliPay Sdk for 仓颉 支付宝接口后端sdk方便cangjie开发者快速接入支付宝的支付接口目前只支持最广泛使用的商户直接接入模式只支持最安全的RSA2公钥证书方式签名验证方式,默认只支持utf-8编码和JSON格式项目地址: https://gitcode.com/Cangjie-SIG/alipay_sdk_cj创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表