README

Omnipay Laravel 支付处理库的 LiqPay 驱动程序

Omnipay 是一个与框架无关、多网关的 PHP 5.5+ 支付处理库。本包实现了 Omnipay 的 LiqPay 支持。

安装

Omnipay 通过 Composer 安装。要安装，只需将其添加到您的 composer.json 文件中

{
    "require": {
        "ucraft-com/omnipay-liqpay": "v1.0.0"
    }
}

然后运行 composer 更新您的依赖项

composer update

或者您可以直接运行

composer require ucraft-com/omnipay-liqpay

基本用法

1. 使用 Omnipay 网关类

    use Omnipay\Omnipay;

1. 初始化 LiqPay 网关

    $gateway = Omnipay::create('LiqPay');
    $gateway->setPublicKey(env('LIQPAY_PUBLIC_KEY'));
    $gateway->setPrivateKey(env('LIQPAY_PRIVATE_KEY'));

1. 调用 purchase，传递所有必要的数据并调用 sendData。它将返回包含表单提交所需所有数据的 Response 对象。

    $request = $gateway->purchase();

    $request->setAmount(10);
    $request->setCurrency('USD');
    $request->setDescription('Product payment.');
    $request->setOrderId(XXXX);
    $request->setResultUrl(env('LIQPAY_RETURN_URL'));
    
    $response = $request->sendData($request->getData());

1. 创建一个 webhook 控制器来处理您的 LIQPAY_RETURN_URL 上的回调请求，并按如下方式捕获 webhook

    $gateway = Omnipay::create('LiqPay');
    $gateway->setPublicKey(env('LIQPAY_PUBLIC_KEY'));
    $gateway->setPrivateKey(env('LIQPAY_PRIVATE_KEY'));
    
    $request = $this->gateway->fetchTransaction();

    $request->setOrderId(XXXX);

    $purchase = $request->send();
    
    // Do the rest with $purchase and response with 'OK'
    if ($purchase->isSuccessful()) {
        // Your logic
    }
    
    return new Response('OK');

有关一般使用说明，请参阅主 Omnipay 仓库。

支持

如果您对 Omnipay 有一般问题，我们建议在 Stack Overflow 上发布。确保添加 omnipay 标签，以便容易找到。

如果您想了解发布公告、讨论项目想法或提出更详细的问题，还有一个您可以订阅的 邮件列表。

如果您认为您找到了一个错误，请使用 GitHub 问题跟踪器 报告它，或者更好的是，分支库并提交一个 pull request。