Skip to content

Latest commit

 

History

History
737 lines (596 loc) · 27.8 KB

README.md

File metadata and controls

737 lines (596 loc) · 27.8 KB
Raw

GitHub forks GitHub forks GitHub forks GitHub

公告 2023-11-3

我辞职不干互联网了，所以一些配置就没了，但是还会留意 issues(有邮件等通知)。有想维护这个 SDK 的小伙伴可以提交对应仓库的 PR。

第三方 token openid 支付 回调 退款 订单查询 手机号 分账 模版消息 仓库
微信小程序 ✓ ✓ ✓ ✓ ✓ ✓ ✓ x ✓ 地址
百度小程序 ✓ ✓ ✓ ✓ ✓ ✓ ✓ x ✓ 地址
抖音小程序 ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ 地址
快手小程序 ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ x 地址
支付宝小程序 x ✓ ✓ ✓ ✓ ✓ ✓ x ✓ 地址
微信 h5 x x ✓ ✓ ✓ ✓ x x x 地址
微信 APP x ✓ ✓ ✓ ✓ ✓ x x x 地址
微信公众号 x x ✓ ✓ ✓ ✓ x x ✓ 地址

安装

composer require code-lives/applet-pays 5.9

⚠️ 注意

金额单位分 100=1 元

微信支付未使用 APIv3 接口规则

获取 openid 接口 统一 openid 字段（因快手返回的 open_id）

返回结果 array 由开发者自行判断

抖音小程序由字节小程序转变而来，支持多端（头条、抖音、今日头条等关联应用）

预下单

// 第一种使用方法 Factory:: ide 自动提示 Weixin
$pay= \Applet\Pay\Factory::Weixin()->init($config)->set("订单号","金额","描述")->getParam();

// 第二种方法
$PayName='Baidu';//百度
$pay= \Applet\Pay\Factory::getInstance($PayName)->init($config)->set("订单号","金额","描述")->getParam();

$PayName='Byte';//抖音
$pay= \Applet\Pay\Factory::getInstance($PayName)->init($config)->set("订单号","金额","描述","描述")->getParam();

$PayName='Weixin';//微信
$pay= \Applet\Pay\Factory::getInstance($PayName)->init($config)->set("订单号","金额","描述","openid")->getParam();

$PayName='Kuaishou';//快手
$pay= \Applet\Pay\Factory::getInstance($PayName)->init($config)->set("订单号","金额","描述",'openid', 'access_token')->getParam();

$PayName='Ali';//支付宝小程序
$pay= \Applet\Pay\Factory::getInstance($PayName)->init($config)->set("订单号","金额","描述",'openid')->getParam();

$PayName='Weixin';//微信公众号【appid 和secret 换成公众号的】
$pay= \Applet\Pay\Factory::getInstance($PayName)->init($config)->set("订单号","金额","描述","openid")->getParam();

$PayName='Weixin';//微信H5【appid 和secret 换成公众号的】
$pay= \Applet\Pay\Factory::getInstance($PayName)->init($config)->set("订单号","金额","描述")->getH5Param();

$PayName='Weixin';//微信APP (没有openid)
$pay= \Applet\Pay\Factory::getInstance($PayName)->init($config)->set("订单号","金额","描述")->getParam();

百度小程序

Config

参数名字 类型 必须 说明
appkey string 是 百度小程序 appkey
payappKey string 是 百度小程序支付 appkey
appSecret string 是 百度小程序 aapSecret
dealId int 是 百度小程序支付凭证
isSkipAudit int 是 默认为 0； 0：不跳过开发者业务方审核；1：跳过开发者业务方审核。
rsaPriKeyStr string 是 私钥（只需要一行长串，不需要文件）
rsaPubKeyStr string 是 百度小程序支付的平台公钥(支付回调需要)
notifyUrl string 否 异步回调地址
refundNotifyUrl string 否 退款异步回调地址

Token

$PayName='Baidu';//设置驱动
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->getToken();
返回参数 类型 必须 说明
expires_in string 是 凭证有效时间，单位：秒
session_key string 是 session_key
access_token string 是 获取到的凭证

Openid

$PayName='Baidu';//设置驱动
$code="";
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->getOpenid($code);
返回参数 类型 必须 说明
session_key string 是 session_key
openid string 是 用户 openid

解密手机号

$PayName='Baidu';//设置驱动
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->decryptPhone($session_key, $iv, $ciphertext);
echo $phone['mobile'];

百度订单查询

参数名字 类型 必须 说明
access_token string 是 根据上面的获取 token
tpOrderId string 是 平台订单号 
$PayName='Baidu';//设置驱动
$Baidu = \Applet\Pay\Factory::getInstance('Baidu')->init($config);
$order = [
        'tpOrderId' => '',//订单号
        'access_token' => $Baidu->getToken()['access_token'],
    ];
$data = $Baidu->findOrder($order);

百度退款

参数名字 类型 必须 说明
access_token string 是 根据上面的获取 token
bizRefundBatchId int 是 百度平台的订单号
isSkipAudit int 是 默认为 0； 0：不跳过开发者业务方审核；1：跳过开发者业务方审核。
orderId int 是 百度平台的订单号
refundReason string 是 退款描述
refundType int 是 退款类型 1：用户发起退款；2：开发者业务方客服退款；3：开发者服务异常退款。百度小程序支付的平台公钥
tpOrderId string 是 自己平台订单号
userId int 是 用户 uid（不是自己平台 uid） 
$order = [
'token' => 'abcd',
'bizRefundBatchId' => 123456,//百度平台订单号
'isSkipAudit' => 1,
'orderId' => 123456,
'refundReason' => '测试退款',
'refundType' => 2,//
'tpOrderId' => '123',//自己平台订单号
'userId' => 123,
];
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->applyOrderRefund($order);

百度小程序模版消息

$data = [
    "touser_openId" => "",
    "template_id" => "",
    "page" => "pages/index/index",
    "subscribe_id" => '百度from组件subscribe-id 一致',
    "data" => json_encode([
        'keyword1' => ['value' => "第一个参数"],
        'keyword2' => ['value' => "第二个参数"],
        'keyword3' =>  ['value' => "第三个参数"],
    ])
];
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->sendMsg($data,$token);
$data=[
   "errno" => 0,
    "msg" => "success",
    "data" => array=> [
    "msg_key" => 1663314134696897
  ]
]

抖音小程序

Config

参数名字 类型 必须 说明
token string 是 担保交易回调的 Token(令牌)
salt string 是 担保交易的 SALT
merchant_id string 是 担保交易的商户号
app_id int 是 小程序的 APP_ID
secret string 是 小程序的 APP_SECRET
notify_url string 是 支付回调 url
settle_url string 否 分账回调 url,没有默认支付回调 url

Token

$PayName='Byte';//驱动
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->getToken();
返回参数 类型 必须 说明
expires_in string 是 凭证有效时间，单位：秒
access_token string 是 获取到的凭证

Openid

$PayName='Byte';//设置驱动
$code="";
$anonymous_code="";//可以不传
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->getOpenid($code,$anonymous_code);
返回参数 类型 必须 说明
session_key string 是 session_key
openid string 是 用户 openid
unionid string 是 unionid

解密手机号

$PayName='Baidu';//设置驱动
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->decryptPhone($session_key, $iv, $encryptedData);
echo $phone['phoneNumber'];

订单查询

$PayName='Byte';//设置驱动
$Baidu = \Applet\Pay\Factory::getInstance($payName)->init($config);
$data = $Baidu->findOrder("订单号");

分账

参数名字 类型 必须 说明
out_order_no string 是 平台订单号
out_settle_no string 是 自定义订单号
settle_desc int 是 分账描述
cp_extra string 是 开发者自定义字段，回调原样回传 
$PayName='Byte';//设置驱动
$Baidu = \Applet\Pay\Factory::getInstance($payName)->init($config);
$data = $Baidu->settle($order);

退款

参数名字 类型 必须 说明
out_order_no string 是 平台订单号
out_refund_no int 是 自定义订单号
reason int 是 退款说明
refund_amount string 是 退款金额 
$order = [
        'out_order_no' => '',
        'out_refund_no' => time() . 'refund',
        'reason' => '就想退款，咋滴',
        'refund_amount' => 1, //退款金额
    ];
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->applyOrderRefund($order);
//返回  [err_no] => 1
//     [err_tips] => 成功
//     [refund_no] => 1212

模版消息

$data = [
        'tpl_id' =>  "模版id",
        "open_id" => $parm['openid'],
        'data' => [
            '律师' => "张三",
            "回复时间" => date('Y-m-d H:i:s', time()),
            "回复内容" => "我回复你啦",
        ],
        "page" => "pages/index/index",
    ];
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->sendMsg($data,$token);

微信小程序

Config

参数名字 类型 必须 说明
appid int 是 小程序 appid
secret int 是 小程序 secret
mch_id string 是 商户 mch_id
mch_key string 是 商户 mch_key
notify_url string 是 异步地址
cert_pem string 是 cert_pem 证书
key_pem string 是 key_pem 证书
trade_type string 是 默认为：JSAPI。MWEB：代表微信 H5 、JSAPI：公众号或小程序

Token

$PayName='Weixin';//驱动
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->getToken();
返回参数 类型 必须 说明
expires_in string 是 凭证有效时间，单位：秒
access_token string 是 获取到的凭证

Openid

$PayName='Weixin';//设置驱动
$code="";
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->getOpenid($code);
返回参数 类型 必须 说明
session_key string 是 session_key
openid string 是 用户 openid
unionid string 是 unionid

微信解密手机号

$PayName='Weixin';//设置驱动
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->decryptPhone($session_key, $iv, $encryptedData);
echo $phone['phoneNumber'];

微信订单查询

$PayName='Weixin';//设置驱动
$Baidu = \Applet\Pay\Factory::getInstance($payName)->init($config);
$data = $Baidu->findOrder("订单号");

微信退款

参数名字 类型 必须 说明
out_trade_no string 是 平台订单号
out_refund_no string 是 自定义订单号
refund_fee int 是 退款金额
total_fee int 是 订单金额
refund_desc string 是 退款原因 
$order = [
        'out_trade_no' => '123',
        'total_fee' => 0.01,
        'out_refund_no' => time(),
        'refund_fee' => 0.01,
    ];
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->applyOrderRefund($order);

微信小程序模版消息

$data = [
    "touser" => "",
    "template_id" => "",
    "page" => "pages/index/index",
    "miniprogram_state" => "developer",
    "lang" => "zh_CN",
    "data" => [
        'thing6' => ['value' => "第一个参数{{thing6.DATA}}"],
        'thing7' => ['value' => "第二个参数{{thing7.DATA}}"],
        'time8' =>  ['value' => "第三个参数{{time8.DATA}}"],
],
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->sendMsg($data,$token);
$data=[
    "errcode" => 0
    "errmsg" => "ok"
    "msgid" => 123456
]

支付宝小程序

使用密钥进行签名解密，没有使用证书签名解密。

订单查询、退款、参数设置可以设置其他，具体看文档。

返回值 看官方文档，每个返回值都不一样，自行判断，如 openid 返回[alipay_system_oauth_token_response] 退款返回[alipay_trade_create_response]

Config

参数名字 类型 必须 说明
appid string 是 小程序 appid
secret string 是 小程序 AES 用于手机号解密
privateKey string 是 应用私钥（开发工具生成）
publicKey string 是 支付宝公钥（支付宝后台下载）
notify_url string 是 异步回调地址

Openid

getOpenid 获取支付宝的用户 user_id 类似于微信的 openid

$PayName='Ali';//设置驱动
$code="";
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->getOpenid($code);
//返回参数
$data = array(
    [alipay_system_oauth_token_response] => Array
        (
            [access_token] => 123
            [alipay_user_id] => 123
            [auth_start] => 2023-03-26 20:56:36
            [expires_in] => 1296000
            [re_expires_in] => 2592000
            [refresh_token] => auth
            [user_id] => 123
        )
    [sign] =>
    )

支付宝小程序解密手机号

$PayName='Ali';//设置驱动
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->decryptPhone($session_key, $iv, $encryptedData);
echo $phone['mobile'];

支付宝小程序订单查询

$PayName='Ali';//设置驱动
$Baidu = \Applet\Pay\Factory::getInstance($payName)->init($config);
$data = $Baidu->findOrder(['out_trade_no' => '1679838318']);

支付宝小程序退款

参数名字 类型 必须 说明
out_trade_no string 是 平台订单号
refund_amount int 是 退款金额 
$orders = [
        'out_order_no' => $order['out_order_no'],
        'refund_amount' => $order['refund_amount'],
    ];
$PayName='Ali';//设置驱动
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->applyOrderRefund($order);

支付宝小程序模版消息

模版消息设置比较麻烦。需要先到开发平台添加进入小程序进行产品绑定，在去商家平台设置文档

$data = [
        'to_user_id' => '用户uid',
        'user_template_id' => '模版id',
        'page' => 'pages/index/index',
        'data' => json_encode([
            'keyword1' => ['value' => '1'],
            'keyword2' =>  ['value' => '2'],
            'keyword3' => ['value' => '3'],
        ]),
    ];
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->sendMsg($data,$token);

快手小程序

Token

$PayName='Kuaishou';//设置驱动
$code="";
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->getToken();

Config

参数名字 类型 必须 说明
app_id int 是 小程序 appid
app_secret int 是 小程序 secret
notify_url string 是 回调地址
settle_url string 是 结算回调地址，没有就默认 notify_url
type int 是 类目

Openid

$PayName='Kuaishou';//设置驱动
$code="";
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->getOpenid($code);
返回参数 类型 必须 说明
session_key string 是 session_key
openid string 是 用户 open_id
result string 是 状态 1 是成功

快手解密手机号

$PayName='Kuaishou';//设置驱动
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->decryptPhone($session_key, $iv, $encryptedData);
echo $phone['phoneNumber'];

快手订单查询

$PayName='Kuaishou';//设置驱动
$Baidu = \Applet\Pay\Factory::getInstance($payName)->init($config);
$data = $Baidu->findOrder("订单号",$access_token);

快手退款

参数名字 类型 必须 说明
out_trade_no string 是 平台订单号
out_refund_no strging 是 自定义订单号
refund_amount int 是 退款金额
reason string 是 退款原因
access_token string 是 access_token
attach string 否 自定义 
$orders = [
        'out_order_no' => $order['out_order_no'],
        'out_refund_no' => $order['out_refund_no'],
        'reason' => $order['reason'],
        'attach' => $order['attach'],
    ];
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->applyOrderRefund($order);

快手结算

参数名字 类型 必须 说明
out_order_no string 是 平台订单号
out_settle_no string 是 自定义订单号
reason string 是 退款原因
access_token string 是 access_token
attach string 否 自定义 
//注意 需要设置回调 notify_url  在config 设置 settle_url 如果没有 默认为 notify_url
$orders = [
        'out_order_no' => $order['out_order_no'],
        'out_settle_no' => $order['out_settle_no'],
        'reason' => $order['reason'],
        'attach' => $order['attach'],
    ];
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->settle($order,$access_token);

订单信息同步

参数名字 类型 必须 说明
out_biz_order_no string 是 展示在用户端的唯一订单号
out_order_no string 是 小程序预下单支付订单号
open_id string 是 订单对应的用户 open id
order_create_time string 是 订单创建时间
order_status string 否 订单状态
order_path string 是 小程序路径
product_cover_img_id string 是 图片 id 
$order = [
        'out_biz_order_no' => '',
        'out_order_no' => '',
        'open_id' => '',
        'order_create_time' => time(),
        'order_status' => 6,
        'order_path' => '',
        'product_cover_img_id' =>'',
    ];
$data = \Applet\Pay\Factory::getInstance($PayName)->init($config)->synchronousOrder($order, $token);

图片上传(订单信息同步)

$data = \Applet\Pay\Factory::getInstance($PayName)->init($config)->imgUpload('图片路径', $token);

快手小程序模版消息

$data = [
    "open_id" => "",
    "tpl_id" => "",
    "page" => "pages/index/index",
    "data" => [
        'key1' =>  "第一个",
        'key2' =>  "第二个",
        'key3' =>  "第三个",
    ]
];
$data= \Applet\Pay\Factory::getInstance($PayName)->init($config)->sendMsg($data,$token);
$data=[
    "err_no" => 1001,
    "err_tips" => "该用户未订阅"
]

微信 APP

Config

参数名字 类型 必须 说明
appid int 是 开发平台 appid
secret int 是 开放平台 secret
mch_id string 是 商户 mch_id
mch_key string 是 商户 mch_key
trade_type string 是 APP
notify_url string 是 异步地址

异步通知

抖音

$pay = \Applet\Pay\Factory::getInstance('Byte')->init($config);
$status = $pay->notifyCheck(); //验证
if ($status) {
    $orderSn = $pay->getNotifyOrder(); //订单数据$orderSn['msg']['cp_orderno'] $orderSn['msg']['seller_uid']
    switch ($orderSn['type']) {
        case 'payment': // 支付相关回调
            /**
             *业务处理
            */
            echo json_encode(['err_no' => 0, 'err_tips' => 'success']);exit; // 操作成功需要给头条返回的信息
            break;
        case 'refund': // 退款相关回调
            /**
             *业务处理
            */
            echo json_encode(['err_no' => 0, 'err_tips' => 'success']);exit; // 操作成功需要给头条返回的信息
            break;
        case 'settle': // 分账相关回调
            /**
             *业务处理
            */
            echo json_encode(['err_no' => 0, 'err_tips' => 'success']);exit; // 操作成功需要给头条返回的信息
            break;
        default: // 未知数据
            return '数据异常';
    }
}

微信回调(通用微信 H5 支付、小程序、微信公众号) 记得改 config 配置

$pay = \Applet\Pay\Factory::getInstance('Weixin')->init($config);
$status = $pay->notifyCheck();//验证
if($status){
    $order = $pay->getNotifyOrder();//订单数据
    //$order['out_trade_no']//平台订单号
    //$order['transaction_id']//微信订单号
    echo 'success';exit;
}

百度小程序回调

$pay = \Applet\Pay\Factory::getInstance('Baidu')->init($config);
$status = $pay->notifyCheck();//验证
if($status){
    $order = $pay->getNotifyOrder();
    //$order['tpOrderId']
    //$order['orderId']
    //$order['userId']
    echo 'success';exit;
}

快手小程序

$pay = \Applet\Pay\Factory::getInstance('Kuaishou')->init($config);
$status = $pay->notifyCheck(); //验证
if ($status) {
    $order = $pay->getNotifyOrder(); //订单数据
    //$order['data']['out_order_no']//平台订单号
    echo json_encode(['result' => 1, 'message_id' => $order['message_id']]);exit;
}

支付宝小程序

$pay = \Applet\Pay\Factory::getInstance('Ali')->init($config);
$status = $pay->notifyCheck(); //验证
if ($status) {
    $order = $pay->getNotifyOrder(); //订单数据
    //$order['out_trade_no']//平台订单号
}

感谢赞助

image image