码支付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与商城系统的免签支付插件模块, 开箱即用,开发者零负担快速接入。
LANGUAGE SDK 编程语言SDK
全语言官方 SDK 工具包
我们为主流编程语言精心封装了官方 SDK 工具包,内置签名算法、接口调用、 回调验签完整逻辑,下载解压后填入配置即可运行示例,大幅节省对接开发时间。
PHP SDK 开发包
- ✓ 封装统一下单、查询、退款、关闭订单接口
- ✓ 内置 MD5 与 HMAC-SHA256 签名算法实现
- ✓ 异步回调自动验签与业务示例代码
- ✓ Composer 一键安装与传统文件加载双模式
- ✓ 集成 PHPUnit 单元测试用例 30+ 条
Java SDK 开发包
- ✓ Maven 中央仓库与 Gradle 双重依赖引入
- ✓ OkHttp3 与 HttpClient 双 HTTP 引擎支持
- ✓ Spring Boot Starter 自动配置启动器
- ✓ 完整订单业务实体类与 Jackson 序列化
- ✓ 回调签名验证工具类开箱即用
Python SDK 开发包
- ✓ requests 与 httpx 双库异步同步支持
- ✓ pip install mapay 命令一键安装
- ✓ 支持 Django/Flask/FastAPI 常见框架
- ✓ Pydantic 数据模型类型安全定义
- ✓ 完整示例:创建订单 + Django 回调视图
Node.js SDK 开发包
- ✓ npm i @mapay/sdk 一条命令完成引入
- ✓ Promise + async/await 现代化调用风格
- ✓ 内置 TypeScript 类型声明 .d.ts 文件
- ✓ 同时适配 CommonJS 与 ESM 模块规范
- ✓ Express/Koa/NestJS 回调处理中间件示例
C# (.NET) SDK
- ✓ NuGet 包 Mapay.Sdk 官方发布
- ✓ HttpClientFactory 依赖注入集成方案
- ✓ ASP.NET Core MVC 回调控制器示例
- ✓ 结构化日志 ILogger 适配输出
- ✓ 多目标框架编译 netstandard2.0
CMS PLUGINS 建站系统插件
主流 CMS & 商城系统 一键安装插件
无需任何代码开发,在您的现有网站后台上传插件、填写配置信息即可完成支付接入, 支持订单自动同步、支付后自动发货、会员自动开通等完整业务联动。
QUICK START 快速开始
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,触发重试