README

此仓库已迁移至 https://github.com/dalenys/php-merchant-api/，将不会接收任何更新

注意：命名空间已从 Be2bill 移至 Dalenys。

[Be2bill 商户 API] (http://developer.be2bill.com/)

Be2bill 支付平台 API 的简单 PHP 实现。

此库紧密遵循官方商户 API 指南。

您可以阅读 APIapiGen 生成文档

安装

Composer

您可以通过将以下行添加到您的 composer.json 文件中来轻松安装此库

{
  "require": {
    "be2bill/php-merchant-api": "1.*"
  }
}

或通过在项目根目录的终端中使用以下命令行

composer require be2bill/php-merchant-api 1.*

手动安装

您可以通过简单地将它克隆到您的项目中并包含脚本 autoload.php 来手动安装此库

使用

构建一个简单的支付表单

以下是一个实现 10€ 简单支付表单的代码示例

<?php

define('BE2BILL_IDENTIFIER', 'YOUR ACCOUNT IDENTIFIER');
define('BE2BILL_PASSWORD', 'YOUR ACCOUNT PASSWORD');

// Just implement BE2BILL_IDENTIFIER and BE2BILL_PASSWORD as defined
$be2bill = Be2bill_Api_ClientBuilder::buildProductionFormClient(BE2BILL_IDENTIFIER, BE2BILL_PASSWORD);

echo $be2bill->buildPaymentFormButton(10000, 'order_123', 'user_123456', 'Payment sample');

支付选项

您可以为 buildPaymentFormButton 方法指定一些额外的选项。最有用的选项是

• CREATEALIAS = yes/no => 询问是否创建续费别名（允许一键支付或订阅式支付）
• 3DSECURE = yes/no => 询问是否需要 3DSECURE 认证
• CARDFULLNAME => 当设置时，持卡人输入将填充指定的数据

有关完整选项列表，请参阅 Be2bill 文档

沙盒环境

您可以通过沙盒环境轻松测试您的集成。此环境将模拟支付而不会处理任何真实金钱转移。您只需使用另一个构建方法

<?php

$be2bill = Be2bill_Api_ClientBuilder::buildSandboxFormClient(BE2BILL_IDENTIFIER, BE2BILL_PASSWORD);

交易编辑

您可以编辑交易：捕获或退款授权。您应该使用直接链接 AP

<?php

$be2bill = Be2bill_Api_ClientBuilder::buildSandboxDirectLinkClient(BE2BILL_IDENTIFIER, BE2BILL_PASSWORD);

$be2bill->capture('A1234', 'order_42', 'capturing a transaction');

测试

首先，您需要将 tests/ftests/config.php.dist 复制到 tests/ftests/config.php

如果您想运行单元测试套件，您可以从项目根目录运行

phpunit tests/utests

如果您想运行功能测试套件（实际向 Be2bill 沙盒发送虚拟支付请求），请编辑 config.php 并将 IDENTIFIER 和 PASSWORD 替换为提供的（沙盒）

phpunit tests/ftests

如果您想运行所有测试，配置功能测试后，简单运行即可

phpunit