PHPackages heleket/php-sdk - 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. heleket/php-sdk ActiveLibrary[API Development](/categories/api) heleket/php-sdk =============== Official PHP SDK for the Heleket cryptocurrency payment API: payments, payouts, balance, exchange rates, and signed webhooks. Zero runtime dependencies. 2.2.0(1w ago)013.4k↓54%1MITPHPPHP >=7.4CI passing Since Jan 30Pushed 1w ago2 watchersCompare [ Source](https://github.com/Heleket/php-sdk)[ Packagist](https://packagist.org/packages/heleket/php-sdk)[ Docs](https://doc.heleket.com/)[ RSS](/packages/heleket-php-sdk/feed)WikiDiscussions main Synced 2d ago READMEChangelog (1)Dependencies (3)Versions (6)Used By (0) Heleket PHP SDK =============== [](#heleket-php-sdk) [![Packagist Version](https://camo.githubusercontent.com/65a30d948383a69024ad4b6ea76b268c59d39b986a9cc566d97155e856b33abe/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f68656c656b65742f7068702d73646b)](https://packagist.org/packages/heleket/php-sdk)[![Total Downloads](https://camo.githubusercontent.com/52e9b9c5f7dfc0fd081f4946b74a8d458562174b38d144728fe1fd65e8cd8973/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f68656c656b65742f7068702d73646b)](https://packagist.org/packages/heleket/php-sdk)[![License](https://camo.githubusercontent.com/c51f5d4be43ba61613b09958a15536bdb68e93b46187773f0143ff36c40b30c9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f68656c656b65742f7068702d73646b)](LICENSE)[![CI](https://github.com/Heleket/php-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/Heleket/php-sdk/actions/workflows/ci.yml) The official PHP SDK for the [Heleket](https://heleket.com) cryptocurrency payment API. Covers the full documented surface (payments, payouts, balance, services, exchange rates), ships with unit tests, runnable examples, a debug mode, a webhook inspector CLI, and a Docker harness. Built to be copied or `composer require`'d directly into your project. Zero runtime dependencies — only `ext-curl` and `ext-json` (bundled with PHP). Quickstart ---------- [](#quickstart) ``` require __DIR__ . '/vendor/autoload.php'; use Heleket\Client; $payment = Client::payment($paymentApiKey, $merchantId); $invoice = $payment->createInvoice([ 'amount' => '15.00', 'currency' => 'USD', 'order_id' => 'order-42', ]); echo $invoice['url']; // → https://pay.heleket.com/pay/ ``` Install ------- [](#install) ``` composer require heleket/php-sdk ``` …or clone this folder into your project and add it to your autoloader. Requirements: PHP 7.4+, `ext-curl`, `ext-json`. **For new deployments, target PHP 8.2+ — 7.4 is end-of-life.** The bundled Docker image uses PHP 8.3. Documentation ------------- [](#documentation) Full reference lives in [`docs/`](docs/README.md): - [01 — Installation](docs/01-installation.md) - [02 — Configuration](docs/02-configuration.md) - [03 — Architecture](docs/03-architecture.md) - [04 — Payments API](docs/04-payments.md) - [05 — Payouts API](docs/05-payouts.md) - [06 — Webhooks](docs/06-webhooks.md) ⚑ critical reading - [07 — Debugging](docs/07-debugging.md) - [08 — Testing](docs/08-testing.md) - [09 — Error handling](docs/09-error-handling.md) - [10 — Reference (statuses, currencies, endpoints)](docs/10-reference.md) - [12 — Troubleshooting (top mistakes)](docs/12-troubleshooting.md) What's in the box ----------------- [](#whats-in-the-box) ``` src/ Production code — zero dependencies beyond ext-curl, ext-json tests/ PHPUnit unit tests + FakeTransport for offline testing examples/ Twelve runnable scripts (01..12) demonstrating every endpoint bin/ heleket-webhook-inspect — CLI to verify and dump any webhook payload docker/ php:7.4-cli-alpine with Composer baked in docs/ Full module documentation in English ``` Common tasks ------------ [](#common-tasks) ``` make install # Composer install make test # PHPUnit make stan # PHPStan level 8 make qa # All quality gates make example-invoice # Create a real invoice (needs .env) make example-webhook # Run the webhook listener on :8000 make docker-shell # Drop into a containerized PHP 7.4 shell make help # Full target list ``` Security notes (read this) -------------------------- [](#security-notes-read-this) - **Always verify webhook signatures.** See [docs/06-webhooks.md](docs/06-webhooks.md). Never trust the payload otherwise. - **Whitelist Heleket's webhook source IP `31.133.220.8`** at your firewall or reverse proxy. - **Never log raw API keys** — the debug dumper logs only the request method, URL, and body (never headers), but a misconfigured logger wrapping the SDK can still capture credentials. - **Two separate API keys** — payments and payouts. Don't mix them up; webhooks of the wrong kind will fail verification. (One exception: `/v1/payment/refund` uses the **payout** key — call `PayoutClient::refund()`.) Releasing --------- [](#releasing) Versions are published to Packagist automatically from git tags on [`github.com/Heleket/php-sdk`](https://github.com/Heleket/php-sdk) (the Packagist ↔ GitHub webhook is already wired up). 1. Land changes on `main`; make sure `make qa` is green. 2. Update [`CHANGELOG.md`](CHANGELOG.md). 3. Tag and push: `git tag 2.1.0 && git push origin 2.1.0`. Packagist picks up the new tag within a minute. The version reported in the `User-Agent` header is read from Composer at runtime, so there is nothing else to bump. **Major versions:** the 1.x line lives on the `1.x` branch (tag `1.0.0`) and must keep working — never delete or move old tags. See [`UPGRADING.md`](UPGRADING.md) for the 1.x → 2.x migration guide. License ------- [](#license) MIT — see [`LICENSE`](LICENSE). ### Health Score 47 — FairBetter than 93% of packages Maintenance98 Actively maintained with recent releases Popularity27 Limited adoption so far Community9 Small or concentrated contributor base Maturity42 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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. ### Release Activity Cadence Every ~127 days Total 5 Last Release 11d ago Major Versions 1.x-dev → 2.0.02026-06-15 PHP version history (2 changes)1.0.0PHP >=5.6 2.0.0PHP >=7.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/4f7cb3fcf1b223715b4dfa9f590a92e3ebe80eacf1ea0e5d27c91dea75d31655?d=identicon)[Heleket](/maintainers/Heleket) --- Top Contributors [![Heleket](https://avatars.githubusercontent.com/u/197054923?v=4)](https://github.com/Heleket "Heleket (5 commits)") --- Tags apicrypto-paymentscryptocurrencyheleketpaymentspayoutsphpsdkwebhooksapisdkcryptopaymentspayoutsheleket ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/heleket-php-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/heleket-php-sdk/health.svg)](https://phpackages.com/packages/heleket-php-sdk) ``` ### Alternatives [transbank/transbank-sdk Transbank SDK 62676.5k14](/packages/transbank-transbank-sdk)[manamine/php-eos-rpc-sdk PHP SDK for the EOS RPC API 187.5k](/packages/manamine-php-eos-rpc-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)