PHPackages tilloops/tillo - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. tilloops/tillo ActiveLibrary[API Development](/categories/api) tilloops/tillo ============== Tillo Api client V2 21.4k↓77.4%1[1 issues](https://github.com/tilloops/tillo/issues)[1 PRs](https://github.com/tilloops/tillo/pulls)PHP Since Jun 22Pushed 3y ago2 watchersCompare [ Source](https://github.com/tilloops/tillo)[ Packagist](https://packagist.org/packages/tilloops/tillo)[ RSS](/packages/tilloops-tillo/feed)WikiDiscussions master Synced yesterday READMEChangelogDependenciesVersions (2)Used By (0) Tillo API Client Library for PHP ================================ [](#tillo-api-client-library-for-php) The Tillo API Client Library enables you to work with Tillo API v2. ### Requirements [](#requirements) - [PHP 7.2.0 or higher](http://www.php.net/) ### API Documentation [](#api-documentation) Installation ============ [](#installation) The preferred method is via [composer](https://getcomposer.org). Follow the [installation instructions](https://getcomposer.org/doc/00-intro.md) if you do not already have composer installed. Once composer is installed, execute the following command in your project root to install this library: ``` composer require tilloops/tillo:dev-master ``` Finally, be sure to include the autoloader: ``` require_once '/path/to/your-project/vendor/autoload.php'; ``` Examples -------- [](#examples) See the [`examples/`](examples) directory for examples of the key client features. ### Basic Example [](#basic-example) **Console Command / Terminal** ``` php examples/console/IssueCode.php --apiKey=xxxxxxx --apiSecret=xxxxxxx --apiBase=xxxxxxx --brand=xxxxxxx --amount=xx.xx ``` *Response* ``` Success to issue the code Request signature: 1a287fa9b034f428b4e892a6801803b613bc0f4e9468ced55a3f603e1ee37c10 Card created successfully Brand : amazon Amount : 42.00 GBP Code : FAA3-9YDQ8E-SMBF Expiration : 04/04/2029 22:59 ``` **Files / Browser** ``` // include your composer dependencies require_once 'vendor/autoload.php'; $apiKey = "YOUR_API_KEY"; $apiSecret = "YOUR_API_SECRET"; $apiBase = "YOUR_API_BASE_URL"; $client = new RewardCloud($apiKey, $apiSecret, $apiBase); $digitalCodeParams = [ 'client_request_id'=> '[[CLIENT_REQUEST_ID]]', 'brand'=> '[[brand_slug]]', 'face_value'=> [ 'amount'=> 6.00, 'currency'=> 'GBP' ], 'delivery_method'=> 'code', 'fulfilment_by'=> 'partner', 'fulfilment_parameters'=> [ 'to_name'=> 'Receiver', 'to_email'=> 'john@reward.cloud', 'from_name'=> 'Reward Cloud', 'from_email'=> 'noreply@reward.cloud', 'subject'=> 'Here is your gift card!' ], 'personalisation'=> [ 'to_name'=> 'Recipient', 'from_name'=> 'Sender', 'message'=> 'Here is your gift', 'template'=> 'standard' ], 'sector'=> 'cash-out' ]; $digitalCode = $client->digitalCode->issue($digitalCodeParams); ``` *Response* ``` $digitalCode [ 'status'=> 'success', 'code'=> '000', 'message'=> 'Human-readable message', 'data'=> [ 'url'=> 'http://revealyourgift.com/blah/blah', 'expiry'=> '2018-05-01', 'serial_number'=> 'Optional serial number', 'security_code'=> 'Optional security code', 'barcode'=> [ 'type'=> 'CODE128', 'string'=> 'ABS1234567', 'url'=> 'https://revealyourgift.com/barcode?code=ABS1234567' ], 'float_balance'=> [ 'currency'=> 'GBP', 'amount'=> 20763.3 ], 'face_value'=> [ 'amount'=> 129.5, 'currency'=> 'GBP' ], 'reference'=> 'Reward Cloud unique reference' ] ] */ ``` ### Available Methods [](#available-methods) - [Digital Gift Cards](#digital-gift-cards) - [Physical Gift Cards](#physical-gift-cards) - [Brand Information](#brand-information) - [Brand Templates](#brand-templates) Digital Gift Cards ------------------ [](#digital-gift-cards) Check [Tillo API Docs](https://api.tillo.tech/) for more information about the parameters MethodDescriptionSyntaxIssue Digital CodeIssue a new digital gift card`$client->digitalCode->issue($params)`Cancel Digital CodeCancel an issued digital gift card`$client->digitalCode->cancel($params)`Reverse Digital CodeReverse a digital gift card`$client->digitalCode->reverse($params)`Cash Out Digital CodeCash out a digital gift card`$client->digitalCode->cashOut($params)`Check StockBrands are able to to top up the stock when running low.`$client->digitalCode->checkStock($params)`Balance CheckCheck the balance of a gift code`$client->digitalCode->checkBalance($params)`Physical Gift Cards ------------------- [](#physical-gift-cards) Check [Tillo API Docs](https://api.tillo.tech/) for more information about the parameters MethodDescriptionSyntaxActivate Physical CardActivate a physical gift card using the gift card number or serial number.`$client->physicalCard->activate($params)`Cancel Activate Physical CardCancel an activated physical gift card using the gift card number or serial number.`$client->physicalCard->cancel($params)`Top-up Physical CardTop up a physical gift card using the gift card number or serial number.`$client->physicalCard->topUp($params)`Cancel Top-up on a Physical CardCancel a top-up on a physical gift card using the gift card number or serial number.`$client->physicalCard->topUpCancel($params)`Cash Out Physical CardCash out a physical gift card`$client->physicalCard->cashOut($params)`Order Physical CardOrder a physical gift card`$client->physicalCard->order($params)`Physical Card Order StatusCheck the status of a physical gift card order`$client->physicalCard->orderStatus($params)`Fulfil Physical Card OrderFulfilment houses can fulfil a physical gift card order`$client->physicalCard->fulfil($params)`Balance Check PhysicalCheck the balance of a physical gift card`$client->physicalCard->balance($params)`Brand Information ----------------- [](#brand-information) These calls are provided to allow your system to retrieve information about the brands you have set up on your account. They can be integrated in to your system to reduce the need to visit our hubs on a regular basis, and automatically update brand information in your own platform. Check [Tillo API Docs](https://api.tillo.tech/) for more information about the parameters. MethodDescriptionSyntaxList BrandsProvides a list of brands and basic information about them.`$client->brand->list($params)`Check FloatsRequest your current Monies on Account and Credit balances.`$client->brand->checkFloat($params)`Brand Templates --------------- [](#brand-templates) Check [Tillo API Docs](https://api.tillo.tech/) for more information about the parameters. MethodDescriptionSyntaxList TemplatesFetch a list of templates, variations and current versions.`$client->template->list($params)`Get TemplateFetch a specific template for a brand.`$client->template->request($params)` ### Health Score 19 — LowBetter than 9% of packages Maintenance10 Infrequent updates — may be unmaintained Popularity22 Limited adoption so far Community11 Small or concentrated contributor base Maturity28 Early-stage or recently created project Bus Factor1 Top contributor holds 60% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/60970472?v=4)[tilloops](/maintainers/tilloops)[@tilloops](https://github.com/tilloops) --- Top Contributors [![tilloops](https://avatars.githubusercontent.com/u/60970472?v=4)](https://github.com/tilloops "tilloops (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)") ### Embed Badge ![Health badge](/badges/tilloops-tillo/health.svg) ``` [![Health](https://phpackages.com/badges/tilloops-tillo/health.svg)](https://phpackages.com/packages/tilloops-tillo) ``` ### Alternatives [exsyst/swagger A php library to manipulate Swagger specifications 35916.4M7](/packages/exsyst-swagger)[hubspot/api-client Hubspot API client 24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol An implementation of the Minecraft: Bedrock Edition protocol in PHP 172445.0k15](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram Telegram driver for BotMan 93459.5k6](/packages/botman-driver-telegram) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)