开发文档 - 芃涵支付

快速开始

通过简单的API调用接入支付系统。支持RESTful接口，提供PHP、Java、Python、Node.js等多种语言SDK。

接入流程：注册商户 → 获取API密钥 → 阅读接口文档 → 技术对接 → 沙箱测试 → 正式上线

统一下单接口

POST /submit.php

创建支付订单，获取支付跳转链接。

请求参数

参数名	类型	必填	说明
pid	int	是	商户ID
type	string	是	支付方式：alipay / wxpay / qqpay
out_trade_no	string	是	商户订单号
notify_url	string	是	异步通知地址
return_url	string	是	同步跳转地址
name	string	是	商品名称
money	string	是	金额（元）
sitename	string	否	站点名称
sign	string	是	MD5签名
sign_type	string	是	签名类型：MD5

请求示例

// PHP 示例
$data = [
    'pid' => '1001',
    'type' => 'alipay',
    'out_trade_no' => 'ORD'.date('YmdHis').rand(1000,9999),
    'notify_url' => 'https://example.com/notify',
    'return_url' => 'https://example.com/return',
    'name' => '测试商品',
    'money' => '1.00',
    'sign_type' => 'MD5',
];
$data['sign'] = md5(http_build_query($data).$key);
$ch = curl_init('https://'.$_SERVER['HTTP_HOST'].'/submit.php');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
            

返回参数

参数名	类型	说明
code	int	状态码：1=成功，-1=失败
msg	string	提示信息
trade_no	string	系统订单号
payurl	string	支付跳转URL
qrurl	string	二维码URL（扫码支付时）

订单查询接口

POST /api.php?act=order

查询订单支付状态。

请求参数

参数名	类型	必填	说明
pid	int	是	商户ID
out_trade_no	string	是	商户订单号
sign	string	是	MD5签名
sign_type	string	是	签名类型：MD5

异步通知

支付完成后，系统会向notify_url发送POST请求，通知商户订单支付结果。

通知参数

参数名	说明
pid	商户ID
trade_no	系统订单号
out_trade_no	商户订单号
type	支付方式
name	商品名称
money	支付金额
trade_status	交易状态：TRADE_SUCCESS=成功
sign	MD5签名
sign_type	签名类型

收到通知后需验证签名，验证通过后返回字符串 success，否则系统会持续重发通知。

SDK下载

我们提供以下语言的SDK，方便快速接入：

PHP SDK

Java SDK

Python SDK

Node.js SDK