README

<title>FastSpring PHP 订阅 API 文档</title>

关于FastSpring

FastSpring 提供了一种创新的电子商务引擎，旨在克服困扰软件电子商务公司的易用性、客户服务和成本问题。我们采用以客户为中心的、迭代的和协作的敏捷开发流程。

关于FastSpring PHP 订阅 API

FastSpring PHP 订阅 API 允许轻松集成FastSpring的订阅服务。提供了一个示例网络应用程序来演示API的用法。所有源代码都根据MIT许可证发布。它开放供贡献，并且其使用不受限制。

如何集成

阅读我们的集成指南，了解如何将您的PHP应用程序与FastSpring的订阅服务集成。

#FastSpring API for PHP#

介绍

FastSpring的PHP订阅API为将PHP应用程序与FastSpring的订阅服务集成提供了一个接口。它提供了管理订阅所需的CRUD操作。

类库

FastSpring订阅API类库提供了一个名为FastSpring的单个类中的CRUD操作。下面描述了此类以及其他用于在API中传递数据的类。

class FastSpring {
	public $test_mode = false;
	
	public function __construct($store_id, $api_username, $api_password) { ... }
	
	public function createSubscription($product_ref, $customer_ref) { ... }
	
	public function getSubscription($subscription_ref) { ... }
	
	public function updateSubscription($subscriptionUpdate) { ... }
	
	public function cancelSubscription($subscription_ref) { ... }
	
	public function renewSubscription($subscription_ref) { ... }
}

如何将FastSpring订阅API添加到您的PHP应用程序中

要开始在您的PHP应用程序中使用FastSpring订阅API，只需将fastspring.php文件包含到您的PHP文件中即可。

然后，使用与您的商店设置匹配的参数实例化一个新的FastSpring对象。

• $store_id
• $api_username
• $api_password

示例

$fastspring = new FastSpring("your_store_id", "your_api_username", "your_api_password");

class FsprgSubscription

public $status;
public $statusChanged;
public $statusReason;
public $cancelable;
public $reference;
public $test;
public $customer;
public $customerUrl;
public $productName;
public $tags;
public $quantity;

class FsprgCustomer

public $firstName;
public $lastName;
public $company;
public $email;
public $phoneNumber;

class FsprgSubscriptionUpdate

public function __construct($subscription_ref) { ... }	

public $productPath;
public $quantity;
public $tags;
public $noEndDate;
public $coupon;
public $discountDuration;
public $proration;

class FsprgException

public $httpStatusCode;
public $errorCode;

示例1 PHP应用程序

本示例展示了如何在具有订阅页面的简单Web应用程序中使用FastSpring订阅API。您需要有一个已配置的FastSpring店铺用于订阅。以下内容需要配置才能使用此示例：

• 订阅产品
• 订阅激活通知
• 订阅停用通知

您需要修改include.php文件，修改以下值以匹配您的店铺设置：

• $store_id
• $api_username
• $api_password
• $test_mode
• product_id

您还需要在activate.php和deactivate.php文件中设置$privateKey变量。此私钥需要分别与订阅激活通知和订阅停用通知中的安全选项卡中的私钥匹配。

请参阅example1/INSTRUCTIONS.txt以获取完整的、分步骤的配置指南。