README

描述

这是Vendasta官方的PHP SDK，用于销售订单的API集成。

要求

• PHP 5.5及以上或PHP 7.0及以上
• PECL（可用于安装所需的PHP扩展）
• Composer
• PHP gmp扩展
• 可选（但推荐）：PHP grpc扩展

安装

安装上述要求，然后

composer require vendasta/sales-orders

认证

为了认证您的SDK调用，您必须从Vendasta平台中配置一个服务账户。

您必须将此文件放在您的服务器上，并设置一个环境变量指向它的路径

export VENDASTA_APPLICATION_CREDENTIALS=<path to credentials.json>

客户端初始化

强烈建议您使用单例客户端实例。每次客户端初始化都会打开自己的连接，因此使用单例可以重用连接，节省时间和资源。

设置环境变量

export ENVIRONMENT=<DEMO or PROD> 

实例化客户端

$environment = getenv("ENVIRONMENT");
if ($environment == null) {
    $environment = "DEMO";
}
$client = new Vendasta\SalesOrders\V1\SalesOrdersClient($environment);

请注意，如果没有指定，环境将被设置为DEM。

创建和激活订单

在业务上创建和激活订单将购买适当的产品，包括允许进行G Suite和GoDaddy配置的辅助函数。

// Create the request
$req = new CreateAndActivateOrderRequest();

// Create the line items
$gSuite = SalesOrdersUtils::buildLineItem('MP-6XDHVMQ84K4THNNP2Z7W2GC28VLHRC4Q');
$goDaddy = SalesOrdersUtils::buildLineItem('MP-NNTJMBF6HPXR5XXC2JKCFWKJ64VZLBFQ');
$lineItems = array($gSuite, $goDaddy);

// Create the custom field
$gSuiteCustomField = SalesOrdersUtils::buildGSuiteCustomField("MP-6XDHVMQ84K4THNNP2Z7W2GC28VLHRC4Q", 'testdomain123.com', 'adminusername', 'First', 'Last', 'example@email.com');
$goDaddyCustomField = SalesOrdersUtils::buildGoDaddyCustomFields("MP-NNTJMBF6HPXR5XXC2JKCFWKJ64VZLBFQ", "testdomain123.com", "example@email.com", "First", "Last", "3065555555", "example@email.com", "First", "Last");
$customFields = array($gSuiteCustomField, $goDaddyCustomField);

// Create the order
$order = SalesOrdersUtils::buildOrder("ABC", "AG-123", $lineItems, $customFields);
$req->setOrder($order);

// Call CreateAndActivateOrder
$resp = $client->CreateAndActivateOrder($req);