码支付SDK下载 · PHP Java Python Node.js C# Go 全语言开发工具包插件

码支付SDK工具包最新版本下载中心,提供PHP、Java、Python、Node.js、C#、Go全语言官方开发SDK, 包含WordPress、ThinkPHP、Z-Blog、Ecshop、ShopXO、Typecho等主流CMS与商城系统的免签支付插件模块, 开箱即用,开发者零负担快速接入。

全语言官方 SDK 工具包

我们为主流编程语言精心封装了官方 SDK 工具包,内置签名算法、接口调用、 回调验签完整逻辑,下载解压后填入配置即可运行示例,大幅节省对接开发时间。

🐘

PHP SDK 开发包

版本号v2.8.3
更新时间2026-07-20
文件大小384 KB
PHP要求PHP 5.6+ / PHP 7 / PHP 8
  • ✓ 封装统一下单、查询、退款、关闭订单接口
  • ✓ 内置 MD5 与 HMAC-SHA256 签名算法实现
  • ✓ 异步回调自动验签与业务示例代码
  • ✓ Composer 一键安装与传统文件加载双模式
  • ✓ 集成 PHPUnit 单元测试用例 30+ 条

Java SDK 开发包

版本号v2.3.1
更新时间2026-06-30
文件大小1.2 MB
PHP要求JDK 1.8 +
  • ✓ Maven 中央仓库与 Gradle 双重依赖引入
  • ✓ OkHttp3 与 HttpClient 双 HTTP 引擎支持
  • ✓ Spring Boot Starter 自动配置启动器
  • ✓ 完整订单业务实体类与 Jackson 序列化
  • ✓ 回调签名验证工具类开箱即用
🐍

Python SDK 开发包

版本号v1.9.0
更新时间2026-07-10
文件大小215 KB
PHP要求Python 3.7+
  • ✓ requests 与 httpx 双库异步同步支持
  • ✓ pip install mapay 命令一键安装
  • ✓ 支持 Django/Flask/FastAPI 常见框架
  • ✓ Pydantic 数据模型类型安全定义
  • ✓ 完整示例:创建订单 + Django 回调视图
💚

Node.js SDK 开发包

版本号v2.0.5
更新时间2026-07-18
文件大小196 KB
PHP要求Node.js 14+
  • ✓ npm i @mapay/sdk 一条命令完成引入
  • ✓ Promise + async/await 现代化调用风格
  • ✓ 内置 TypeScript 类型声明 .d.ts 文件
  • ✓ 同时适配 CommonJS 与 ESM 模块规范
  • ✓ Express/Koa/NestJS 回调处理中间件示例
🔷

C# (.NET) SDK

版本号v1.6.2
更新时间2026-05-28
文件大小820 KB
PHP要求.NET 5 / .NET Core / Framework 4.6+
  • ✓ NuGet 包 Mapay.Sdk 官方发布
  • ✓ HttpClientFactory 依赖注入集成方案
  • ✓ ASP.NET Core MVC 回调控制器示例
  • ✓ 结构化日志 ILogger 适配输出
  • ✓ 多目标框架编译 netstandard2.0
🐹

Go 语言 SDK

版本号v1.4.1
更新时间2026-07-02
文件大小148 KB
PHP要求Go 1.18+ (支持泛型)
  • ✓ go get github.com/mapay/sdk-go 快速引入
  • ✓ context.Context 请求链路透传支持
  • ✓ 高性能 JSON 编解码免反射方案
  • ✓ Gin/Echo/Fiber 三大主流框架示例
  • ✓ 零依赖纯标准库版本单独提供

主流 CMS & 商城系统 一键安装插件

无需任何代码开发,在您的现有网站后台上传插件、填写配置信息即可完成支付接入, 支持订单自动同步、支付后自动发货、会员自动开通等完整业务联动。

W

WordPress 插件

对接 WooCommerce 商城、付费阅读、会员订阅、下载站等常用场景

版本 v3.2.1
适配 WP 5.8 ~ 6.6+
下载插件
T

ThinkPHP 插件

ThinkPHP 5.x / 6.x / 8.x 全版本支付扩展包,含 trait 与中间件

版本 v2.4.0
适配 TP 5 / 6 / 8
下载插件
Z

Z-Blog 插件

Z-BlogPHP 博客系统的付费文章、VIP会员、付费资源下载插件

版本 v1.8.3
适配 Z-Blog 1.6/1.7
下载插件
E

Ecshop 支付模块

Ecshop 商城系统官方支付模块,购物车结算、订单管理全流程打通

版本 v2.1.0
适配 Ecshop 3.x/4.x
下载插件
S

ShopXO 插件

ShopXO B2C 商城与多商户商城码支付官方插件,后台可视化配置

版本 v1.5.2
适配 ShopXO 2.x Pro
下载插件
T

Typecho 插件

轻博客 Typecho 付费文章、文章打赏、会员订阅扩展插件

版本 v1.3.0
适配 Typecho 1.2+
下载插件
D

DedeCMS 模块

织梦 CMS 内容付费阅读、付费下载、模型字段扩展插件模块

版本 v1.2.4
适配 DedeCMS V5.7
下载插件
G

帝国CMS 插件

帝国CMS 7.5 版 内容付费、积分充值、会员升级支付插件

版本 v1.1.0
适配 EmpireCMS 7.5
下载插件

3 行代码完成接入

简洁直观的 API 设计,让开发者聚焦业务而非复杂的支付对接逻辑。 以下为 PHP SDK 最简化的下单调用示例。

PHP SDK · 统一下单调用示例
<?php
require './Mapay/autoload.php';

use Mapay\Client as MapayClient;

// 1. 初始化客户端,填入AppID与AppSecret
$config = [
    'appid'     => 'MP20240001',
    'appsecret' => 'YOUR_APP_SECRET_HERE',
    'gateway'   => 'https://api.mapay.example.com/v1/'
];
$mapay = new MapayClient($config);

// 2. 组装订单参数发起支付
$order = $mapay->order()->create([
    'out_trade_no' => 'O' . date('YmdHis') . rand(100, 999),
    'total_fee'    => 19800,                  // 订单金额:单位分
    'body'         => '黄金会员 - 年度套餐',  // 商品标题
    'pay_type'     => 'wxpay',                // 支付方式 wxpay / alipay
    'notify_url'   => 'https://yoursite.com/callback.php',
    'return_url'   => 'https://yoursite.com/return.php'
]);

// 3. 获取二维码链接引导用户支付
if ($order['code'] == 1) {
    $qrCodeUrl = $order['data']['qr_code'];
    $jsApiArgs = $order['data']['jsapi'];   // 公众号H5场景使用
    header('Location: ' . $order['data']['pay_url']);
} else {
    echo '下单失败:' . $order['msg'];
}
PHP SDK · 异步回调处理示例
<?php
require './Mapay/autoload.php';
use Mapay\Client as MapayClient;

// 实例化客户端
$mapay = new MapayClient([
    'appid'     => 'MP20240001',
    'appsecret' => 'YOUR_APP_SECRET_HERE'
]);

// 1. 接收并验证签名(自动从 POST 读取)
$verify = $mapay->notify()->verify($_POST);
if (!$verify) {
    die('签名验证失败,非法请求');
}

// 2. 获取订单数据
$notifyData = $mapay->notify()->getData();
$outTradeNo = $notifyData['out_trade_no'];  // 商户订单号
$totalFee   = $notifyData['total_fee'];     // 订单金额
$status     = $notifyData['status'];        // 1=支付成功

// 3. 校验金额匹配 & 执行业务逻辑
if ($status == 1) {
    // 根据订单号查询您的数据库订单并标记已支付
    // 例如:发货、开通会员、充值点券、解锁付费内容等
    $db->updateOrderPaid($outTradeNo, $totalFee);

    // ⚠️ 业务处理完成后必须返回 success 字符串
    die('success');
}

die('fail');  // 如果未执行业务则返回非 success,触发重试