Pingpp PHP SDK 简介 lib 文件夹下是 PHP SDK 文件,example 文件夹里面是简单的接入示例,该示例仅供参考。 版本要求 PHP 版本 8.1 及以上 PHP 5.6.xPHP7.x 请使用 2.6.0) 你可以执行目录下的环境检测脚本,来进行一些检测。
Pingpp PHP SDK 简介 lib 文件夹下是 PHP SDK 文件,example 文件夹里面是简单的接入示例,该示例仅供参考。 版本要求 PHP 版本 8.1 及以上 PHP 5.6.xPHP7.x 请使用 2.6.0) 你可以执行目录下的环境检测脚本,来进行一些检测。
lib 文件夹下是 PHP SDK 文件,
example 文件夹里面是简单的接入示例,该示例仅供参考。
PHP 版本 8.1 及以上
PHP 5.6.x~PHP7.x 请使用2.6.0)
你可以执行目录下的环境检测脚本,来进行一些基本检测
php PingppEnvInspect.php执行
composer require pingplusplus/pingpp-php使用 Composer 的 autoload 引入
require_once('vendor/autoload.php');require_once('/path/to/pingpp-php/init.php');\Pingpp\Pingpp::setApiKey('YOUR-KEY');密钥需要你自己生成,公钥请填写到 Ping++ Dashboard
\Pingpp\Pingpp::setPrivateKeyPath('/path/to/your_rsa_private_key.pem');\Pingpp\Pingpp::$caBundle = '/path/to/cacert.pem';不设置时,会默认使用 SDK 包含的 CA 证书。 如果需要手动更新 CA 证书,可从 下载,并使用此方法设置证书路径。
$ch = \Pingpp\Charge::create([
'order_no' => '123456789',
'app' => ['id' => 'APP_ID'],
'channel' => 'alipay',
'amount' => 100,
'client_ip' => '127.0.0.1',
'currency' => 'cny',
'subject' => 'Your Subject',
'body' => 'Your Body',
'extra' => $extra,
]);\Pingpp\Charge::retrieve('CHARGE_ID');\Pingpp\Charge::all(['limit' => 5, 'app' => ['id' => 'APP_ID']]);$re = \Pingpp\Refund::create('ch_a9CmfHTGGaz1urHiL8m5OiX1', [
'amount' => 1,
'description' => 'Your Descripton',
]);\Pingpp\Refund::retrieve('CHARGE_ID', 'REFUND_ID');\Pingpp\Refund::all('CHARGE_ID',[
'limit' => 5,
]);\Pingpp\RedEnvelope::create([
'order_no' => '123456789',
'app' => ['id' => 'APP_ID'],
'channel' => 'wx_pub',
'amount' => 100,
'currency' => 'cny',
'subject' => 'Your Subject',
'body' => 'Your Body',
'extra' => [
'nick_name' => 'Nick Name',
'send_name' => 'Send Name',
],
'recipient' => 'Openid',
'description' => 'Your Description',
]);\Pingpp\RedEnvelope::retrieve('RED_ID');\Pingpp\RedEnvelope::all(['limit' => 5]);如果使用微信 JS-SDK 来调起支付,需要在创建 charge 后,获取签名(signature),传给 HTML5 SDK。
$jsapi_ticket_arr = \Pingpp\WxpubOAuth::getJsapiTicket($wx_app_id, $wx_app_secret);
$ticket = $jsapi_ticket_arr['ticket'];正常情况下,jsapi_ticket 的有效期为 7200 秒。由于获取 jsapi_ticket 的 api 调用次数非常有限,频繁刷新 jsapi_ticket 会导致 api 调用受限,影响自身业务,开发者必须在自己的服务器全局缓存 jsapi_ticket。
下面方法中 $url 是当前网页的 URL,不包含 # 及其后面部分
$signature = \Pingpp\WxpubOauth::getSignature($charge, $ticket, $url);然后在 HTML5 SDK 里调用
pingpp.createPayment(charge, callback, signature, false);\Pingpp\Event::retrieve('EVT_ID');\Pingpp\Event::all(['type' => 'charge.succeeded']);详细信息请参考 API 文档。
\Pingpp\Transfer::create([
'amount' => 100,
'order_no' => '123456d7890',
'currency' => 'cny',
'channel' => 'wx_pub',
'app' => ['id' => 'APP_ID'],
'type' => 'b2c',
'recipient' => 'o9zpMs9jIaLynQY9N6yxcZ',
'description' => 'testing',
'extra' => ['user_name' => 'User Name', 'force_check' => true]
]);\Pingpp\Transfer::retrieve('TR_ID');\Pingpp\Transfer::reverse('TR_ID');\Pingpp\Transfer::all(['limit' => 5]);\Pingpp\Identification::identify([
'type' => 'id_card',
'app' => $app_id,
'data' => [
'id_name' => '张三', // 姓名
'id_number' => '310181198910107641' // 身份证号
]
]);\Pingpp\Identification::identify([
'type' => 'bank_card',
'app' => $app_id,
'data' => [
'id_name' => '张三', // 姓名
'id_number' => '310181198910107641', // 身份证号,
'card_number' => '6201111122223333', // 银行卡号
'phone_number' => '18623234545' // 银行预留手机号,不支持 178 号段
]
]);…\Pingpp\BatchTransfer::retrieve('181611151506412852'); // 批量转账对象id ,由 Ping++ 生成\Pingpp\BatchTransfer::all(['page' => 1]);\Pingpp\BatchRefund::create(
[
'app' => APP_ID,
'batch_no' => uniqid('batch'), // 批量退款批次号,3-24位,允许字母和英文
'description' => 'Your Description', // 批量退款详情,最多 255 个 Unicode 字符
'charges' => [ // 需要退款的 charge id 列表,一次最多 100 个
'ch_qn5G8GH1SOCCvnv10S8mXTqP',
'ch_SijjXL8Ki1u1arL1S49q5ifL'
]
]
);\Pingpp\BatchRefund::retrieve('151611141520583238'); // 批量退款对象id ,由 Ping++ 生成\Pingpp\BatchRefund::all(['page' => 1]);…\Pingpp\Customs::retrieve('14201609281040220109'); // 报关对象 ID,由 Ping++ 生成\Pingpp\Order::create([
"amount" => 100,
"app" => APP_ID,
"merchant_order_no" => "88888888888", //商户订单号
"subject" => "subj{$order_no}",
"currency" => "cny",
"body" => "body{$order_no}",
"uid" => "test_user_001",
"client_ip" => "192.168.0.101",
]);\Pingpp\Order::pay('2011611170000003651', [
'balance_amount' => 0,
'charge_amount' => 10,
'channel' => 'alipay',
'extra' => [
'key' => 'value',
],
]);\Pingpp\Order::cancel('2011611170000003651'); // 订单对象 ID,由 Ping++ 生成\Pingpp\Order::retrieve('2011611170000003651'); // 订单对象 ID,由 Ping++ 生成$params = ['app' => APP_ID];
\Pingpp\Order::all($params);\Pingpp\OrderRefund::create('2011708070000007521', [
'description' => 'Your description', //退款附加说明。
'metadata' => [],
'refund_mode' => 'to_source', //退款模式。原路退回:to_source,退至余额:to_balance。默认为原路返回。
]);\Pingpp\OrderRefund::retrieve('2011611160000343961', 're_OW1CSS8KCS0KvfzDu5jTerrH');\Pingpp\OrderRefund::all('2011611160000343961');\Pingpp\Recharge::create([
'user' => 'user_test_01',
'charge' => [
'amount' => 100,
'channel' => 'alipay_qr',
'order_no' => substr(md5(time()), 0, 10),
'subject' => 'Your subject',
'body' => 'Your recharge body',
'time_expire' => time()+ 3600,
'client_ip' => '127.0.0.1',
'extra' => [],
],
'balance_bonus' => [
'amount' => 10,
],
'from_user' => 'user_test_01',
'description' => 'Your description',
'metadata' => [],
]);\Pingpp\Recharge::retrieve('221170807730968330240000')$params = [
'page' => 1,
'per_page' => 100,
];
\Pingpp\Recharge::all($params);\Pingpp\Recharge::refund('221170807730968330240000', [
'description' => 'Rechage refund description',
]);\Pingpp\Recharge::refund_retrieve('221170807730968330240000', 're_iTqLaTe1WTmHvXjrv9i5C8G4')\Pingpp\Recharge::refundList('221170807730968330240000') \Pingpp\User::create([
'id' => uniqid('uid'), // 用户 ID ,由商户提供
]);\Pingpp\User::retrieve('uid582d35283f628');\Pingpp\User::update($uid, [
'address' => 'Shanghai',
'name' => 'User Name',
'metadata' => [
'key' => 'value'
],
]);$users = \Pingpp\User::all([
'page' => 1,
'per_page' => 10,
]);\Pingpp\CouponTemplate::create([
'name' => '25OFF', // 优惠券模板名称
'type' => 2, // 优惠券模板的类型 1:现金券;2:折扣券
'percent_off' => 25, // 折扣百分比, 如 20 表示 8 折, 100 表示免费
'amount_available' => 10000, // 订单金额大于等于该值时,优惠券有效(适用于满减);0 表示无限制
'max_circulation' => 1000, // 优惠券最大生成数量,当已生成数量达到最大值时,不能再生成优惠券;默认 null,表示可以无限生成
'metadata' => [], // metadata
'expiration' => null, // 优惠券模板过期策略
]);\Pingpp\CouponTemplate::all([
'page' => 1,
'per_page' => 10,
]);\Pingpp\CouponTemplate::retrieve('300116082415452100000700');$ct = \Pingpp\CouponTemplate::update('300116082415452100000700', [
'metadata' => [
'keys' => 'value',
]
]);\Pingpp\CouponTemplate::delete('300116082415452100000700');$coupon_tmpl_id = '300216111711085500022401'; // Ping++ 返回的优惠券模板 ID
$params = [
'users' => [
'uid582d1756b1650',
'uid582d1756b1651',
],
];
\Pingpp\CouponTemplate::batchCreateCoupons($coupon_tmpl_id, $params);\Pingpp\CouponTemplate::couponsList('300216111711085500022401'); // Ping++ 返回的优惠券模板 ID$user_id = 'uid582d1756b1650'; // 用户 ID
$params = [
'coupon_template' => '300216111619300600019101', // 优惠券模版 ID
];
\Pingpp\Coupon::create($user_id, $params);$user_id = 'uid582d1756b1650'; // 用户 ID
$coupon_id = '300416111711463500023901'; // 优惠券 ID
\Pingpp\Coupon::retrieve($user_id, $coupon_id);// 更新 Coupon 对象
$user_id = 'uid582d1756b1650'; // 用户 ID
$coupon_id = '300416111711571500024101'; // 优惠券 ID
$params = [
'metadata' => [
'key' => 'value',
],
];
\Pingpp\Coupon::update($user_id, $coupon_id, $params);$user_id = 'uid582d1756b1650'; // 用户 ID
$coupon_id = '300416111711463500023901'; // 优惠券 ID
\Pingpp\Coupon::delete($user_id, $coupon_id);$user_id = 'uid582d1756b1650'; // 用户 ID
$search_params = [ //搜索条件,此数组可以为空
'page' => 1, //页码,取值范围:1~1000000000;默认值为"1"
'per_page' => 2, //每页数量,取值范围:1~100;默认值为"20"
];
\Pingpp\Coupon::all($user_id, $search_params);$params = [
'withdrawals' => [
'1701611150302360654',
'1701611151015078981',
]
];
\Pingpp\BatchWithdrawal::confirm($params);$params = [
'withdrawals' => [
'1701611150302360654',
'1701611151015078981',
]
];
\Pingpp\BatchWithdrawal::cancel($params);
\Pingpp\BatchWithdrawal::retrieve('1901611151015122025'); //批量提现对象 ID。$params = [
'per_page' => 20,
'page' => 1
];
\Pingpp\BatchWithdrawal::all($params);\Pingpp\BalanceTransaction::all([]);\Pingpp\BalanceTransaction::retrieve('310216111501260200000601');$params = [
"user" => 'u-s.e_r1479281694040', // 用户 ID
"amount" => 200, // 转账金额
"channel" => 'unionpay', // 提现使用渠道。银联:unionpay,支付宝:alipay,微信:wx
"user_fee" => 10, // 用户需要承担的手续费
"description" => "test232description",
"order_no" => time() . mt_rand(11111, 99999), // 提现订单号,为长度不大于 16 的数字
"extra" => [
"card_number" => "6214888888888888",
"user_name" => "张三",
"open_bank_code" => "0102",
"prov" => "上海",
"city" => "上海",
],
];
\Pingpp\Withdrawal::create($params);\Pingpp\Withdrawal::retrieve('1711611161932569404');\Pingpp\Withdrawal::all([
'per_page' => 3
]);\Pingpp\BalanceBonus::create([
'amount' => 10,
'description' => '余额赠送描述',
'user' => 'user_test_01',
'order_no' => substr(md5(time()), 0, 10),
]);\Pingpp\BalanceBonus::retrieve('651170807590953932800000');\Pingpp\BalanceBonus::all()\Pingpp\BalanceTransfer::create(
[
'amount' => 10,
'user_fee' => 0,
'user' => 'user_001',
'recipient' => '0',
'order_no' => substr(md5(random_bytes(64)), 0, 10),
'description' => 'Your descript暂无开放 Issues,或尚未同步最近议题。