README

Flow SDK

最简单（非官方）的Flow SDK。

Flow是一个智利支付网关，作为Webpay Plus、Onepay、Servipag、Multicaja和CryptoCompra的中介。

使用Flow，您无需在每个服务中注册并遵守其SDK、API或合同。Flow将负责收款并将资金交付给您的商店，无论客户使用何种支付方式（您想启用哪些），通过一个单一的通用接口。

要求

• Flow账户
• PHP 7.1.3+
• ext-json
• ext-openssl
• ext-curl

如果您需要PHP 5.6兼容性，可以查看遗产分支。

如果您正在使用Laravel，请查看Laraflow，它将优雅地将应用程序与该包连接起来。

安装

使用Composer将此包安装到您的项目中。

composer require darkghosthunter/flow-sdk

手动安装

如果您没有Composer，您需要下载composer.phar，如果它在全球系统中不可用，则需要手动安装PHP。

完成后，将此包下载到您的服务器（或您的计算机）上，并将composer.phar文件放入其中。然后，让Composer下载所需的包

cd /path/to/flow-sdk

path/to/php composer.phar install --optimize-autoloader --apcu-autoloader --no-dev

然后在代码中的任何地方调用Composer自动加载器来加载此包

<?php

// Load the Flow SDK.
include_once(__DIR__ . '/path/to/flow-sdk/vendor/autoloader.php');

// Load my app
include_once(__DIR__ . '/www/index.php');

如果您在自己的计算机上这样做，建议将包压缩并上传到您的服务器，然后在服务器上使用Web UI文件管理器解压缩它。上传多个文件可能需要您花费很多时间，尤其是在FTP下。

用法

Flow SDK旨在非常易于表达且直接。此代码应说明我们在做什么，而无需阅读手册。

<?php

use DarkGhostHunter\FlowSdk\Flow;

$flow = Flow::make('production', [
    'apiKey'    => '1F90971E-8276-4713-97FF-2BLF5091EE3B',
    'secret'    => 'f8b45f9b8bcdb5702dc86a1b894492303741c405',
]);

$paymentResponse = $flow->payment()->commit([
    'commerceOrder'     => 'order#123',
    'subject'           => 'Console',
    'amount'            => 99990,
    'email'             => 'johndoe@mail.com',
    'urlConfirmation'   => 'https://myapp.com/flow/confirm',
    'urlReturn'         => 'https://myapp.com/flow/return',
    'optional'          => [
        'Message' => 'Your order is being shipped!'
    ]
]);

header('Location: '. $paymentResponse->getUrl());

当然，始终建议RTFM。有关如何详细使用该包的信息，请参阅Wiki。

扩展

此包使用语义版本控制。

只需提交一个具有良好代码质量和所有测试通过的PR（拉取请求），或添加新的测试，以添加新功能、修复错误、清理等。

示例

如果您迷路了，需要快速原型设计，或者只是想了解某个特定的交易过程如何运作，请查看examples目录。

PHP 5.6 兼容性

请查看legacy分支以支持PHP 5.6。由于它被认为是遗留的，不能保证其保持更新。

建议尽快迁移到PHP 7.1及以上版本。PHP 5.6及以下版本，以及PHP 7.0及以下版本，将在2019年1月1日之后不再得到支持。之后的日期将不再为旧的PHP版本提供安全发布。[¹¹]

许可证

本软件包采用MIT许可证授权。

本软件包与包中提到的任何服务、公司、产品及/或服务没有任何直接或间接的关系。