README

这是用于与Chargebee集成的PHP库。在这里注册Chargebee账户 这里。

Chargebee现在支持两个API版本 - V1 和 V2，其中V2是最新版本，所有未来的开发都将发生在V2上。这个库是针对API版本V2的。如果您需要V1，请转到chargebee-v1分支。

需求

PHP 5.6.0 或更高版本

安装

Composer

Chargebee 可在 Packagist 上找到，并可以使用 Composer 安装

composer require chargebee/chargebee-php

要使用绑定，

require_once('vendor/autoload.php');

手动安装

下载最新的发布版，并使用绑定时，包含 init.php 文件。

require_once('/path/to/chargebee-php/lib/init.php');

文档

• API参考

使用方法

创建新的订阅

use ChargeBee\ChargeBee\Environment;
use ChargeBee\ChargeBee\Subscription;

Environment::configure("your_site", "{your_site_api_key}");
$result = Subscription::create([
    "id" => "__dev__KyVqH3NW3f42fD",
    "planId" => "starter",
    "customer" => [
        "email" => "john@user.com",
        "firstName" => "John",
        "lastName" => "Wayne"
    ]
]);
$subscription = $result->subscription();
$customer = $result->customer();
$card = $result->card();

创建幂等请求

幂等键 与请求头一起传递，以便安全地重试POST请求。

use ChargeBee\ChargeBee\Environment;
use ChargeBee\ChargeBee\Models\Customer;

Environment::configure("your_site", "{your_site_api_key}");
$result = Customer::create(array(
    "email" => "john@test.com",
    "first_name" => "john"
    ), 
    null, 
    array(
        "chargebee-idempotency-key" => "<<UUID>>"
        )
    ); // Replace <<UUID>> with a unique string
$customer = $result->customer();
print_r($customer);

$responseHeaders = $result->getResponseHeaders(); // Retrieves response headers
print_r($responseHeaders);
$idempotencyReplayedValue = $result->isIdempotencyReplayed(); // Retrieves Idempotency replayed header value
print_r($idempotencyReplayedValue);

可以通过访问 isIdempotencyReplayed() 方法来区分原始请求和重放请求。

遗留支持

如果您正在使用PHP < 5.6.0，您可以下载chargebee-php v2.8.3。这个版本不会支持最近添加的功能，因为该版本已经发布。我们建议您升级PHP以使用最新功能。

许可

请参阅LICENSE文件。