哪吒收银 (nezha-cashier) 用起来很是轻松的支付 sdk

GitHub

https://github.com/RunnerLee/...

支持

名称	网关	支持动做	支持回调	备注
alipay_app	支付宝 APP 支付	支付/支付查询/退款	支付
alipay_qr	支付宝扫码支付	支付/支付查询/退款	支付
alipay_wap	支付宝手机网站支付	支付/支付查询/退款	支付
alipay_web	支付宝 PC 网站支付	支付/支付查询/退款	支付
wechat_app	微信 APP 支付	支付/支付查询/退款/退款查询	支付通知/退款通知
wechat_h5	微信 H5 支付	支付/支付查询/退款/退款查询	支付通知/退款通知	内置抓取付款连接功能
wechat_mina	微信小程序支付	支付/支付查询/退款/退款查询	支付通知/退款通知
wechat_official	微信公众号支付	支付/支付查询/退款/退款查询	支付通知/退款通知
wechat_qr	微信扫码支付	支付/支付查询/退款/退款查询	支付通知/退款通知
union_web	银联网页支付	支付/支付查询	支付通知	较旧版本
union_app	银联网页支付	支付	支付通知	较旧版本
paypal_express_checkout	PayPal 快速结帐	支付/支付查询	支付通知	不稳定

介绍

在对接第三方支付中, 尤为是须要对接多个第三方支付时, 须要阅读第三方文档而后花费大量时间拼装和调试参数, 例如调用第三方下单建立支付, 若是须要同时接入微信跟支付宝支付, 那么就须要收集文档, 可想而知是很是麻烦的(其实还好.. hhh..).

这个组件提供的把与第三方通讯分为三部分:

1. request, 请求, 主动调用第三方
2. response, 响应, 主动调用第三方得到的响应
3. notification, 通知, 第三方的各种通知

而每部分又部分为不一样的动做, 每一个动做绑定一个固定的表单 (Form), 每一个表单的内容是固定的.

例如主动调用第三方下单建立支付 (ChargeRequest), 他使用的表单是 ChargeRequestForm. 填写好表单后, 传入组件, 便可由组件加工好参数并调用第三方支付.

这样就能作到, 只须要了解组件的表单内容, 就能够接入多个第三方支付, 一劳永逸 (不存在的 hhh).

使用

这里以支付宝 PC 网站支付为例, 若是须要使用其余的支付网关, 只须要修改实例化 Cashier 时传入的 $gateway 便可.

注意, 组件使用的基本货币单位是 分.

<?php

use Runner\NezhaCashier\Cashier;

// 按格式组装好配置
$config = [
    'app_id' => 'xxxx',
    'app_private_key' => 'xxxxx',
    'alipay_public_key' => 'xxxxx',
];

// 建立实例, 传入要使用的 Gateway
$cashier = new Cashier('alipay_web', $config);

建立付款

<?php
// 组装 ChargeRequestForm
$data = [
    'order_id' => '151627101400000071',
    'subject' => 'testing',
    'amount' => 1,
    'currency' => 'CNY',
    'description' => 'testing description',
    'return_url' => 'https://www.baidu.com',
    'expired_at' => '2018-01-23 19:00:00',
];

$form = $cashier->charge($data);

// 以 laravel 为例
return redirect($form->get('charge_url'));

查询支付

<?php

$form = $cashier->query([
    'order_id' => '151627101400000071',
]);

var_dump('paid' === $form->get('status'));

接收通知

<?php
$form = $cashier->notify('charge');

var_dump('paid' === $form->get('status'));

var_dump($form->get('trade_sn'));   // 取得第三方交易号

退款

<?php

$form = $cashier->refund([
    'order_id' => '151627101400000071',
    'refund_id' => '3151627101400000071',
    'total_amount' => 1,
    'refund_amount' => 1,
]);

表单及字段说明

ChargeRequestForm

字段名	是否必须	字段说明	备注
order_id	是	订单号
subject	是	订单标题
amount	是	订单金额	注意部分支付渠道有金额上线限制
currency	是	订单货币	注意支付渠道支付
description	是	订单简述	支付渠道会有不一样的长度限制
user_ip	否	用户IP
return_url	否	回调地址	web类型的支付渠道必须填
show_url	否	展现地址
body	否	订单详细说明	这个参数我应该删掉
expired_at	否	过时时间	unix 时间戳
created_at	否	建立时间	unix 时间戳, 想不到吧, 连这个鬼都要??

其余依旧待补充...

FAQ

Q: 相比其余的 sdk 优势在哪 ?

A: 不管标榜多优雅多好用的 sdk, 大多都是要求你按照第三方的参数名传入参数, 那就免不了要看文档, 免不了在代码里要作不少处理. 我想要的是, 从数据库里取出订单后, 作一遍处理就能解决接入多种支付.

Q: 是否是就彻底没必要看第三方支付的文档了 ?

A: 并非, 我建议仍是须要看, 而且组件中某些支付 (例如微信公众号) 是须要传入一些特殊参数的. 组件只是帮你解决烦心的调用问题.

License

MIT