incenteev/async-amazon-incentives

SDK for the Amazon Incentives API based on the structure of the async-aws project

v1.0.0 2023-07-11 17:08 UTC

Requires

• php: ^8.1
• ext-dom: *
• ext-simplexml: *
• async-aws/core: ^1.9

Requires (Dev)

• async-aws/code-generator: dev-master
• friendsofphp/php-cs-fixer: ^3.18
• phpstan/phpstan: ^1.10
• phpstan/phpstan-deprecation-rules: ^1.1
• phpstan/phpstan-phpunit: ^1.3
• phpunit/phpunit: ^10.2

MIT

• Christophe Coevoet

• amazon
• giftcard
• AmazonGiftCode
• AGCOD
• Incentives API
• Amazon Incentives API

README

This package provides an unofficial SDK for the Amazon Incentives API.

Installation

Use Composer to install the library:

$ composer require incenteev/async-amazon-incentives

Usage

use AsyncAws\Core\Configuration;
use Incenteev\AsyncAmazonIncentives\AmazonIncentivesClient;
use Incenteev\AsyncAmazonIncentives\Enum\CurrencyCode;
use Incenteev\AsyncAmazonIncentives\Exception\SystemTemporarilyUnavailableException;
use Incenteev\AsyncAmazonIncentives\Region;
use Incenteev\AsyncAmazonIncentives\ValueObject\MoneyAmount;

// Get your credentials in the Amazon Incentives portal
$accessKey = '';
$secretKey = '';
$partnerId = '';

// Choose the region corresponding to your partnership, with either the sandbox or production one.
$region = Region::EUROPE_AND_ASIA_SANDBOX;

$client = new AmazonIncentivesClient([
    Configuration::OPTION_ACCESS_KEY_ID => $accessKey,
    Configuration::OPTION_SECRET_ACCESS_KEY => $secretKey,
    Configuration::OPTION_REGION => $region,
]);

try {
    $result = $client->createGiftCard([
        'partnerId' => $partnerId,
        'creationRequestId' => '', // Create the proper request id
        'value' => new MoneyAmount(['amount' => 10, 'currencyCode' => CurrencyCode::EUR]),
    ]);

    $code = $result->getGcClaimCode();
} catch (SystemTemporarilyUnavailableException $e) {
    // TODO handle temporary failures according to the Amazon Incentives best practices
}

Note: due to the async nature of the project, the exception is not actually thrown by the call to createGiftCard but when the Result object gets resolved.

License

This package is under the MIT license.

Reporting an issue or a feature request

Issues and feature requests are tracked in the Github issue tracker.