PHPackages oxapay/oxapay-laravel - 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. [Payment Processing](/categories/payments) 4. / 5. oxapay/oxapay-laravel ActiveLibrary[Payment Processing](/categories/payments) oxapay/oxapay-laravel ===================== Official Laravel SDK for OxaPay crypto payment gateway (Laravel 8-13). 1.0.0(7mo ago)0951Apache-2.0PHPPHP ^8.0 Since Nov 28Pushed 2mo agoCompare [ Source](https://github.com/OxaPay/oxapay-laravel)[ Packagist](https://packagist.org/packages/oxapay/oxapay-laravel)[ Docs](https://oxapay.com)[ RSS](/packages/oxapay-oxapay-laravel/feed)WikiDiscussions main Synced today READMEChangelog (1)Dependencies (7)Versions (2)Used By (0) OxaPay Laravel SDK ================== [](#oxapay-laravel-sdk) Official Laravel SDK for [OxaPay](https://oxapay.com) โ€” accept crypto payments, exchanges, and payouts. > **Frameworks:** Laravel 8โ€“13 > **PHP:** 8.0+ (Laravel 8โ€“9) / 8.1+ (Laravel 10) / 8.2+ (Laravel 11โ€“12) / 8.3+ (Laravel 13) > **Docs:** Installation ------------ [](#installation) ``` composer require oxapay/oxapay-laravel ``` ### Publish `config/oxapay.php` [](#publish-configoxapayphp) ``` php artisan oxapay:install ``` > You can use `--force` flag to overwrite config from package > Service provider and facade are auto-discovered. ### Add your keys to `.env` or update oxapay config: [](#add-your-keys-to-env-or-update-oxapay-config) ``` OXAPAY_MERCHANT_KEY=your_merchant_api_key OXAPAY_PAYOUT_KEY=your_payout_api_key OXAPAY_GENERAL_KEY=your_general_api_key ``` > You can define multiple slots. --- Quick start ----------- [](#quick-start) ``` use OxaPay\Laravel\Support\Facades\OxaPay; // via facade $res = OxaPay::payment()->generateInvoice([ 'amount' => 10.5, 'currency' => 'USDT' ]); // via helper $res = oxapay()->payment()->generateInvoice([ 'amount' => 10.5, 'currency' => 'USDT' ]); // key is optional and use default key from config if no passed $res = OxaPay::payment('key_2')->generateInvoice([ 'amount' => 10.5, 'currency' => 'USDT' ]); // or use raw key $res = OxaPay::payment("XXXXXX-XXXXXX-XXXXXX-XXXXXX")->generateInvoice([ 'amount' => 10.5, 'currency' => 'USDT' ]); ``` Handling Webhooks (Payments & Payouts) ------------------------------------------ [](#handling-webhooks-payments--payouts) ``` use OxaPay\Laravel\Support\Facades\OxaPay; try{ $res = OxaPay::webhook()->getData(); // ... }catch (WebhookSignatureException $e) { // ... } // or you can get data without verify HMAC $res = OxaPay::webhook()->getData(false); ``` --- Available methods ----------------- [](#available-methods) ### ๐Ÿ”นpayment [](#payment) - `generateInvoice` โ€“ Create invoice & get payment URL. [More details](https://docs.oxapay.com/api-reference/payment/generate-invoice) - `generateWhiteLabel` โ€“ White-label payment. [More details](https://docs.oxapay.com/api-reference/payment/generate-white-label) - `generateStaticAddress` โ€“ Create static deposit address. [More details](https://docs.oxapay.com/api-reference/payment/generate-static-address) - `revokeStaticAddress` โ€“ Revoke static address. [More details](https://docs.oxapay.com/api-reference/payment/revoking-static-address) - `staticAddressList` โ€“ List static addresses. [More details](https://docs.oxapay.com/api-reference/payment/static-address-list) - `information` โ€“ Single payment information. [More details](https://docs.oxapay.com/api-reference/payment/payment-information) - `history` โ€“ Payment history list. [More details](https://docs.oxapay.com/api-reference/payment/payment-history) - `acceptedCurrencies` โ€“ Accepted currencies. [More details](https://docs.oxapay.com/api-reference/payment/accepted-currencies) ### ๐Ÿ”นaccount [](#account) - `balance` โ€“ Account balance. [More details](https://docs.oxapay.com/api-reference/common/account-balance) ### ๐Ÿ”นpayout [](#payout) - `generate` โ€“ Request payout. [More details](https://docs.oxapay.com/api-reference/payout/generate-payout) - `information` โ€“ Single payout information. [More details](https://docs.oxapay.com/api-reference/payout/payout-information) - `history` โ€“ Payout history list. [More details](https://docs.oxapay.com/api-reference/payout/payout-history) ### ๐Ÿ”นexchange [](#exchange) - `swapRequest` โ€“ Swap request. [More details](https://docs.oxapay.com/api-reference/swap/swap-request) - `swapHistory` โ€“ Swap history. [More details](https://docs.oxapay.com/api-reference/swap/swap-history) - `swapPairs` โ€“ Swap pairs. [More details](https://docs.oxapay.com/api-reference/swap/swap-pairs) - `swapCalculate` โ€“ Swap pre-calc. [More details](https://docs.oxapay.com/api-reference/swap/swap-calculate) - `swapRate` โ€“ Swap Quote rate. [More details](https://docs.oxapay.com/api-reference/swap/swap-rate) ### ๐Ÿ”นcommon [](#common) - `prices` โ€“ Market prices. [More details](https://docs.oxapay.com/api-reference/common/prices) - `currencies` โ€“ Supported crypto. [More details](https://docs.oxapay.com/api-reference/common/supported-currencies) - `fiats` โ€“ Supported fiats. [More details](https://docs.oxapay.com/api-reference/common/supported-fiat-currencies) - `networks` โ€“ Supported networks. [More details](https://docs.oxapay.com/api-reference/common/supported-networks) - `monitor` โ€“ System status. [More details](https://docs.oxapay.com/api-reference/common/system-status) ### ๐Ÿ”นwebhook [](#webhook) - `verify` โ€“ Validates `HMAC` header (sha512 of raw body). - `getData` โ€“ Validates `HMAC` header and return webhook data. [More details](https://docs.oxapay.com/webhook) --- Exceptions ---------- [](#exceptions) All SDK exceptions extend `OxaPay\Laravel\Exceptions\OxaPayException`: - `ValidationRequestException` (HTTP 400) - `InvalidApiKeyException` (HTTP 401) - `NotFoundException` (HTTP 404) - `RateLimitException` (HTTP 429) - `ServerErrorException` (HTTP 500) - `ServiceUnavailableException` (HTTP 503) - `HttpException` (network/unknown) - `MissingApiKeyException` (missing api key) - `MissingTrackIdException` (missing track id) - `MissingAddressException` (missing address) - `WebhookSignatureException` (bad/missing HMAC) - `WebhookNotReceivedException` (webhook request was not received) ### Security Notes [](#security-notes) - Verify webhook HMAC before use input data. - Whitelist OxaPay IPs on your firewall (ask support). - Use HTTPS everywhere. - Store keys in `.env`, not code. - Rotate keys regularly. --- Testing (safe & offline) ---------------------------- [](#testing-safe--offline) This package uses **Pest**, **PHPUnit**, and **Orchestra Testbench** for testing. Dependencies are already listed under `require-dev` in `composer.json`. Run tests with composer: ``` composer test ``` Run tests with pest: ``` vendor/bin/pest ``` --- Compatibility ------------- [](#compatibility) - Laravel 8โ€“9 โ†’ PHP 8.0+ - Laravel 10 โ†’ PHP 8.1+ - Laravel 11โ€“12 โ†’ PHP 8.2+ Security -------- [](#security) If you discover a security vulnerability, please email . Do not disclose publicly until it has been fixed. Contributing ------------ [](#contributing) Pull requests are welcome. For major changes, open an issue first. Run coding standards & static analysis before PR: ``` composer cs-fix composer phpstan composer test ``` License ------- [](#license) Apache-2.0 โ€” see [LICENSE](https://github.com/OxaPay/oxapay-laravel/blob/HEAD/LICENSE). Changelog --------- [](#changelog) See [CHANGELOG.md](https://github.com/OxaPay/oxapay-laravel/blob/HEAD/CHANGELOG.md) for version history. --- OxaPay Made with โ™ฅ for Laravel. ### Health Score 35 โ€” LowBetter than 77% of packages Maintenance75 Regular maintenance activity Popularity11 Limited adoption so far Community9 Small or concentrated contributor base Maturity40 Maturing project, gaining track record 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. ### Release Activity Cadence Unknown Total 1 Last Release 218d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/176389822?v=4)[oxapaysdk](/maintainers/oxapaysdk)[@oxapaysdk](https://github.com/oxapaysdk) --- Top Contributors [![OxaPay](https://avatars.githubusercontent.com/u/119416034?v=4)](https://github.com/OxaPay "OxaPay (3 commits)")[![wislert](https://avatars.githubusercontent.com/u/7439798?v=4)](https://github.com/wislert "wislert (2 commits)") --- Tags laravelsdkcryptopaymentsgatewayoxapay ### Code Quality TestsPest Static AnalysisPHPStan Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/oxapay-oxapay-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/oxapay-oxapay-laravel/health.svg)](https://phpackages.com/packages/oxapay-oxapay-laravel) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[laravel/mcp Rapidly build MCP servers for your Laravel applications. 77022.3M151](/packages/laravel-mcp)[api-platform/laravel API Platform support for Laravel 58171.5k14](/packages/api-platform-laravel) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)