PHPackages orkhanahmadov/goldenpay - 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. orkhanahmadov/goldenpay ActiveLibrary[Payment Processing](/categories/payments) orkhanahmadov/goldenpay ======================= GoldenPay payment library for PHP and Laravel framework 2.2(4y ago)1050211MITPHPPHP ^7.3|^8.0CI failing Since May 1Pushed 4y ago2 watchersCompare [ Source](https://github.com/orkhanahmadov/goldenpay)[ Packagist](https://packagist.org/packages/orkhanahmadov/goldenpay)[ GitHub Sponsors](https://github.com/orkhanahmadov)[ RSS](/packages/orkhanahmadov-goldenpay/feed)WikiDiscussions master Synced 2w ago READMEChangelog (1)Dependencies (4)Versions (12)Used By (1) πŸ’³ [GoldenPay](http://www.goldenpay.az) library for PHP ====================================================== [](#credit_card-goldenpay-library-for-php) #### If you are using Laravel, you can use [`laravel-goldenpay`](https://github.com/orkhanahmadov/laravel-goldenpay) package instead for better integration with extra features. [](#if-you-are-using-laravel-you-can-use-laravel-goldenpay-package-instead-for-better-integration-with-extra-features) [![Latest Stable Version](https://camo.githubusercontent.com/085a67ed0d41fad99ea8b1bb784ea52a6b6faf9398cd0dd6f2c607c4cef1b731/68747470733a2f2f706f7365722e707567782e6f72672f6f726b68616e61686d61646f762f676f6c64656e7061792f762f737461626c65)](https://packagist.org/packages/orkhanahmadov/goldenpay)[![Latest Unstable Version](https://camo.githubusercontent.com/310645b0be8e2fd18c69e740e3f18b111ea9f33e42f92a3d0bd6f19dd636d79f/68747470733a2f2f706f7365722e707567782e6f72672f6f726b68616e61686d61646f762f676f6c64656e7061792f762f756e737461626c65)](https://packagist.org/packages/orkhanahmadov/goldenpay)[![Total Downloads](https://camo.githubusercontent.com/1d6e2d95ba455f7fd9649de4dfcb83e5ba3678529787f6e85b8948ab02a0b979/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f726b68616e61686d61646f762f676f6c64656e706179)](https://packagist.org/packages/orkhanahmadov/goldenpay)[![GitHub license](https://camo.githubusercontent.com/e4c95fc0807f463e867c13cb551610d678f3742752fd5d4405f55a9f11c768cc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6f726b68616e61686d61646f762f676f6c64656e7061792e737667)](https://github.com/orkhanahmadov/goldenpay/blob/master/LICENSE.md) [![Build Status](https://camo.githubusercontent.com/2db577ce288c24e9d1345fb91d060c2c7bd51dd89dc185c2ddcbd339901d2d07/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6f726b68616e61686d61646f762f676f6c64656e7061792e737667)](https://travis-ci.org/orkhanahmadov/goldenpay)[![Test Coverage](https://camo.githubusercontent.com/4c6d59856bdd4754e543617c39de091a93e5093643445ab1d9b44e671c389d4a/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f39326230356530383739326438633230346366362f746573745f636f766572616765)](https://codeclimate.com/github/orkhanahmadov/goldenpay/test_coverage)[![Maintainability](https://camo.githubusercontent.com/e640edd63a76eb3217585b450eef09f2ff8972d87fed94d744405e7e2a6ac0b4/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f39326230356530383739326438633230346366362f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/orkhanahmadov/goldenpay/maintainability)[![Quality Score](https://camo.githubusercontent.com/d07e62249e850eb937b2b6227b16a85c66ea5977942017bab1f7407cfda08166/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6f726b68616e61686d61646f762f676f6c64656e7061792e737667)](https://scrutinizer-ci.com/g/orkhanahmadov/goldenpay)[![StyleCI](https://camo.githubusercontent.com/7df98bf8614647c1b23608b80ad2c01a36e05f7c4ed64854093a13ccf437f43a/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3138343236353630302f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/184265600) Requirements ------------ [](#requirements) **PHP 7.2** or higher, with `json` extension. Installation ------------ [](#installation) ``` composer require orkhanahmadov/goldenpay ``` Usage ----- [](#usage) First, instantiate `Orkhanahmadov\Goldenpay\Goldenpay` and call `authenticate()` method with "auth key" and "merchant name". Both can be acquired from [Goldenpay merchant dashboard](https://rest.goldenpay.az/merchant/). ``` use Orkhanahmadov\Goldenpay\Goldenpay; $goldenpay = new Goldenpay(); $goldenpay->authenticate('auth-key-here', 'merchant-name-here'); ``` ### Getting payment key [](#getting-payment-key) To get new payment key use `payment` method. Method accepts following arguments: - **Amount** - Amount to charge. Only integer accepted. For example 10.25 needs to be converted to 1025 - **Card type** - Requires instance of `Orkhanahmadov\Goldenpay\Enums\CardType`. `CardType::VISA()` for VISA, `CardType::MASTERCARD()` for MasterCard - **Description** - Payment related description - **Language** *(optional)* - Sets payment page interface language. Requires instance of `Orkhanahmadov\Goldenpay\Enums\Language`. `Language::EN()` for english, `Language::RU()` for russian, `Language::AZ()` for azerbaijani. Default is azerbaijani ``` $paymentKey = $goldenpay->payment(100, CardType::VISA(), 'item-description', Language::EN()); ``` Method will return instance of `Orkhanahmadov\Goldenpay\Response\PaymentKey`. You can access payment key and payment url from this object instance. ``` $paymentKey->getCode(); // endpoint response code $paymentKey->getMessage(); // endpoint response message $paymentKey->getPaymentKey(); // unique payment key $paymentKey->paymentUrl(); // payment url. you should redirect user to this url to start payment ``` **Important!** Goldenpay charges all payments only in AZN. ### Checking payment result [](#checking-payment-result) To check payment result use `result` method. Method accepts following arguments: - **Payment key** - Previously available payment key ``` $paymentResult = $goldenpay->result('payment-key-here'); ``` Method also accepts instance of `Orkhanahmadov\Goldenpay\Response\PaymentKey` as an argument. Method will return instance of `Orkhanahmadov\Goldenpay\Response\PaymentResult`. You can access following properties from this object instance: ``` $paymentResult->getCode(); // status code $paymentResult->getMessage(); // status message $paymentResult->getPaymentKey(); // instance of Orkhanahmadov\Goldenpay\Response\PaymentKey $paymentResult->getMerchantName(); // merchant name $paymentResult->getAmount(); // charged amount in integer format. 100 = 1.00 $paymentResult->getCheckCount(); // shows how many times this payment key result checked $paymentResult->getPaymentDate(); // \DateTimeImmutable instance of payment date $paymentResult->getCardNumber(); // charged card number. only first 6 digits and last 4 digits. Example: 422865******8101 $paymentResult->getLanguage(); // 2 letter interface language: 'lv', 'en' or 'ru' $paymentResult->getDescription(); // description used for payment $paymentResult->getReferenceNumber(); // payment reference number ``` You can also use global helper function. Calling this function requires passing "auth key" and "merchant name". ``` $goldenpay = goldenpay('auth-key-here', 'merchant-name-here'); // returns instance of "Orkhanahmadov\Goldenpay\Goldenpay" $goldenpay->payment(100, CardType::VISA(), 'your-description', Language::EN()); ``` `Orkhanahmadov\Goldenpay\Goldenpay` implements `Orkhanahmadov\Goldenpay\GoldenpayInterface`. You can use this interface as abstraction for dependency injection. Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Orkhan Ahmadov](https://github.com/orkhanahmadov) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 34 β€” LowBetter than 75% of packages Maintenance20 Infrequent updates β€” may be unmaintained Popularity20 Limited adoption so far Community11 Small or concentrated contributor base Maturity72 Established project with proven stability 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 ~82 days Recently: every ~182 days Total 11 Last Release 1794d ago Major Versions 1.3.0 β†’ 2.0.02019-11-15 PHP version history (4 changes)1.0.0PHP >=7.2.0 1.2.0PHP >=7.1.0 2.0.0PHP ^7.2.0 2.2PHP ^7.3|^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/c82e54991e0224fdc49d34ee60d0cfce5ea0cca1cd59771155e3b372d1fa1d11?d=identicon)[orkhanahmadov](/maintainers/orkhanahmadov) --- Top Contributors [![orkhanahmadov](https://avatars.githubusercontent.com/u/7041590?v=4)](https://github.com/orkhanahmadov "orkhanahmadov (95 commits)") --- Tags azerbaijangoldenpaylaravellibrarypaymentpaymentazerbaijanorkhanahmadovgoldenpay ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/orkhanahmadov-goldenpay/health.svg) ``` [![Health](https://phpackages.com/badges/orkhanahmadov-goldenpay/health.svg)](https://phpackages.com/packages/orkhanahmadov-goldenpay) ``` ### Alternatives [shetabit/multipay PHP Payment Gateway Integration Package 293355.3k4](/packages/shetabit-multipay)[bitpay/sdk Complete version of the PHP library for the new cryptographically secure BitPay API 42352.5k4](/packages/bitpay-sdk)[sebdesign/laravel-viva-payments A Laravel package for integrating the Viva Payments gateway 4849.3k](/packages/sebdesign-laravel-viva-payments)[paypayopa/php-sdk PHP SDK for PayPay Open Payment API 18304.2k4](/packages/paypayopa-php-sdk)[eslazarev/wildberries-sdk Wildberries OpenAPI clients (generated). 252.5k](/packages/eslazarev-wildberries-sdk)[robokassa/sdk-php SDK для Ρ€Π°Π±ΠΎΡ‚Ρ‹ с Robokassa Π² PHP 1111.7k](/packages/robokassa-sdk-php) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)