pandagrouppl/subuno-php-api

Minimal software development kit for connecting with Subuno API in PHP applications.

1.0.3 2022-06-24 10:13 UTC

Requires

• php: ^7.4||^8.0||^8.1
• ext-curl: *
• doctrine/annotations: ^1
• guzzlehttp/guzzle: ^6||^7
• psr/cache: ^1||^2||^3
• symfony/cache: *
• symfony/validator: ^4.4||^5.4||^6

proprietary

• Panda Group
• Paweł Micnas

README

How to use Subuno SDK:

1. Create configuration class that implements ConfigInterface

class TestConfig implements \PandaGroup\SubunoApi\Contract\ConfigInterface

You can save your api keys in database, env file, and wherever you want - the most important is to return it in the Configuration class.

2. Create new client:

$config = new TestConfig();
$client = new \PandaGroup\SubunoApi\Client($config)

3. Invoke method execute on client with selected params in argument 'query':

$client->execute(['t_id' => 213]);

4. Using QueryBuilder and DataObjects

You can also use QueryBuilder and DataObjects (which is recommended) to build request that will be send to Subuno API. There are three types of data objects that represents different types of information proceed by Subuno API:

\PandaGroup\SubunoApi\DataObject\BillingInformation
\PandaGroup\SubunoApi\DataObject\OrderInformation
\PandaGroup\SubunoApi\DataObject\ShippingInformation

Use Factory class to create new data objects:

/** @var \PandaGroup\SubunoApi\DataObject\Factory\Factory $factory*/
$orderInfo = $factory->create(\PandaGroup\SubunoApi\DataObject\OrderInformation::class, ['transactionId' => 123]);

And pass data objects to query builder:

/** @var \PandaGroup\SubunoApi\Request\Builder\QueryBuilder $queryBuilder */
$queryBuilder->add($orderInfo)
$query = $queryBuilder->build()

Variable $query pass to execute method in client object.

$response = $client->execute($query);