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 11.3k↓50%1[1 PRs](https://github.com/tilloops/tillo/pulls)PHP Since Jun 22Pushed 3y ago1 watchersCompare [ Source](https://github.com/tilloops/tillo)[ Packagist](https://packagist.org/packages/tilloops/tillo)[ RSS](/packages/tilloops-tillo/feed)WikiDiscussions master Synced 1mo ago 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 21 — LowBetter than 18% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity22 Limited adoption so far Community10 Small or concentrated contributor base Maturity27 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 [stripe/stripe-php Stripe PHP Library 4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk PHP SDK for Facebook Business 90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 265103.1M454](/packages/google-gax)[google/common-protos Google API Common Protos for PHP 173103.7M50](/packages/google-common-protos) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)