PHPackages peteruu-maxpay/hpp-client - 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. peteruu-maxpay/hpp-client ActiveLibrary[Payment Processing](/categories/payments) peteruu-maxpay/hpp-client ========================= Maxpay PHP Library v1(1y ago)0108MITPHPPHP >=7.1 Since Oct 22Pushed 1y agoCompare [ Source](https://github.com/peteruu/maxpay-php-hpp-client)[ Packagist](https://packagist.org/packages/peteruu-maxpay/hpp-client)[ Docs](https://maxpay.com/)[ RSS](/packages/peteruu-maxpay-hpp-client/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (3)Versions (2)Used By (0) You can sign up for a maxpay account at Requirements ============ [](#requirements) PHP 7.1 and later. Composer ======== [](#composer) You can install the bindings via [Composer](http://getcomposer.org/). Run the following command: ``` composer require maxpay/hpp-client ``` To use the bindings, use Composer's [autoload](https://getcomposer.org/doc/00-intro.md#autoloading): ``` require_once('vendor/autoload.php'); ``` Getting Started =============== [](#getting-started) Simple payment form: -------------------- [](#simple-payment-form) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); echo $scriney->buildButton('userId')->buildPopup(); ``` Payment form with pre selected product: --------------------------------------- [](#payment-form-with-pre-selected-product) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); echo $scriney->buildButton('userId')->setProductId('productIdInMportal')->buildPopup(); ``` Payment form with filled user information: ------------------------------------------ [](#payment-form-with-filled-user-information) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); echo $scriney->buildButton('userId')->setUserInfo( new \Maxpay\Lib\Model\UserInfo( 'example@example.com', 'John', 'Anderson', 'USA', 'Los angeles', '90217', '2896 Providence Lane', '6267746913' ) )->buildPopup(); ``` Payment form with custom return urls: ------------------------------------- [](#payment-form-with-custom-return-urls) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); echo $scriney->buildButton('userId')->setSuccessReturnUrl( "https://example.com/success" )->setDeclineReturnUrl( "https://example.com/decline" )->setBackUrl( "https://example.com/back" )->buildPopup(); ``` Payment form with custom params, params will be returned in callback: --------------------------------------------------------------------- [](#payment-form-with-custom-params-params-will-be-returned-in-callback) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); echo $scriney->buildButton('userId')->setCustomParams( [ 'custom_param1' => 'param value 1', 'custom_param2' => 'param value 2' ] )->buildPopup(); ``` Payment form with dynamic products: ----------------------------------- [](#payment-form-with-dynamic-products) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); echo $scriney->buildButton('userId')->setCustomProducts( [ new \Maxpay\Lib\Model\FixedProduct( 'myProducId1', 'Garden Table', 198.98, 'USD', null, null, 'Magic Garden Table & Set of 2 Chairs' ), new \Maxpay\Lib\Model\FixedProduct( 'myProducId2', 'Chair', 110.50, 'USD', null, null, 'Magic Garden Rocking Chair' ) ] )->buildPopup(); ``` Valdiate callback data: ----------------------- [](#valdiate-callback-data) $data - json string of callback response data read from file\_get\_contents('php://input'); $headers - array of callback response headers ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); if ($scriney->validateCallback($data, $headers)) { echo 'callback data is valid'; } else { echo 'invalid callback data'; } ``` Api === [](#api) Rebilling api ------------- [](#rebilling-api) ### Create simple rebilling request by existing product [](#create-simple-rebilling-request-by-existing-product) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); try { $result = $scriney->createRebillRequest( '569ded06-c1c0-4ecb-9b9c-59c1630f6969', 'userId' )->setProductId( 'p_3ba675d110' )->setUserInfo( new \Maxpay\Lib\Model\UserInfo( 'example@example.com', 'John', 'Anderson', 'USA', 'Los angeles', '90217', '2896 Providence Lane', '6267746913' ) )->send(); } catch (\Maxpay\Lib\Exception\GeneralMaxpayException $e) { // } if ($scriney->validateApiResult($result)) { //Api result is valid } ``` ### Create rebilling request with custom product and custom params [](#create-rebilling-request-with-custom-product-and-custom-params) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); try { $result = $scriney->createRebillRequest( '569ded06-c1c0-4ecb-9b9c-59c1630f6969', 'userId' )->setUserInfo( new \Maxpay\Lib\Model\UserInfo( 'example@example.com', 'John', 'Anderson', 'USA', 'Los angeles', '90217', '2896 Providence Lane', '6267746913' ) )->setCustomProduct( new \Maxpay\Lib\Model\FixedProduct( 'myProducId1', 'Garden Table', 198.98, 'USD', null, null, 'Magic Garden Table & Set of 2 Chairs' ) )->setCustomParams( [ 'custom_param_name1' => 'value 1', 'custom_param_name2' => 'value 2' ] )->send(); } catch (\Maxpay\Lib\Exception\GeneralMaxpayException $e) { // } if ($scriney->validateApiResult($result)) { //Api result is valid //Api result example: /* Array ( [transactionId] => hppR1463555724.2658mId548aId9 [uniqueUserId] => userId [totalAmount] => 198.98 [currency] => USD [transactionType] => SALE [status] => success [message] => Transaction processed successfully [code] => 0 [productList] => Array ( [0] => Array ( [productId] => myProducId1 [name] => Garden Table [amount] => 198.98 [currency] => USD ) ) [customParameters] => Array ( [custom_param_name1] => value 1 [custom_param_name2] => value 2 ) [checkSum] => 285e7c239dd8945b49157e36c0000692932e3dca04e8581ffa43abecef260beb ) */ } ``` Cancel subscription api ----------------------- [](#cancel-subscription-api) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); $result = $scriney->stopSubscription('hppR1463555724.2658mId548aId9', 'userId'); if ($scriney->validateApiResult($result)) { //Api result is valid } ``` Cancel post trial product api ----------------------------- [](#cancel-post-trial-product-api) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); $result = $scriney->cancelPostTrial('hppR1463555724.2658mId548aId9'); if ($scriney->validateApiResult($result)) { //Api result is valid } ``` Full/partial Refund api ----------------------- [](#fullpartial-refund-api) ``` $scriney = new \Maxpay\Scriney('publicKey', 'privateKey'); $result = $scriney->refund('hppR1463555724.2658mId548aId9', 123.24, 'USD'); if ($scriney->validateApiResult($result)) { //Api result is valid } //Api result example /* Array ( [message] => Refund processed successfully, but all subscriptions already stopped. [status] => Success [transactionId] => hppAR1468587714.1807mId548aId9 [checkSum] => ee7ecd3b401735c40c5da4c3dcaf38952df5721d9626402cbbc1ccadd65b5616 ) */ ``` Development =========== [](#development) Install dependencies: ``` composer install ``` ### Health Score 24 — LowBetter than 32% of packages Maintenance38 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community12 Small or concentrated contributor base Maturity33 Early-stage or recently created project Bus Factor2 2 contributors hold 50%+ of commits 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 564d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/3a9d2c04ca787d91393992965c8af8c5dbd8d10bfefd860658b7119acc7d14fb?d=identicon)[peteruu](/maintainers/peteruu) --- Top Contributors [![SergeyMiheev](https://avatars.githubusercontent.com/u/3327613?v=4)](https://github.com/SergeyMiheev "SergeyMiheev (13 commits)")[![EugeniyPetrov](https://avatars.githubusercontent.com/u/2155621?v=4)](https://github.com/EugeniyPetrov "EugeniyPetrov (11 commits)")[![dbyvalin](https://avatars.githubusercontent.com/u/64464506?v=4)](https://github.com/dbyvalin "dbyvalin (6 commits)")[![VyacheslavDolya](https://avatars.githubusercontent.com/u/3057705?v=4)](https://github.com/VyacheslavDolya "VyacheslavDolya (6 commits)")[![max-d](https://avatars.githubusercontent.com/u/5785681?v=4)](https://github.com/max-d "max-d (4 commits)")[![peteruu](https://avatars.githubusercontent.com/u/46679749?v=4)](https://github.com/peteruu "peteruu (3 commits)")[![aleksandr-cherniy](https://avatars.githubusercontent.com/u/247553902?v=4)](https://github.com/aleksandr-cherniy "aleksandr-cherniy (3 commits)") --- Tags pspmaxpay ### Code Quality Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/peteruu-maxpay-hpp-client/health.svg) ``` [![Health](https://phpackages.com/badges/peteruu-maxpay-hpp-client/health.svg)](https://phpackages.com/packages/peteruu-maxpay-hpp-client) ``` ### Alternatives [dnetix/redirection Library to connect with PlacetoPay Checkout service 17123.3k2](/packages/dnetix-redirection)[valiton/payum-payone The Payum extension. It provides PAYONE payment integration. 1114.6k](/packages/valiton-payum-payone)[vipps/module-payment Vipps MobilePay Payment Module for Magento 2 1195.4k](/packages/vipps-module-payment)[paymentsuite/paymentsuite PaymentSuite is an easy implementation for lot of Payment Methods for Symfony projects 2715.5k2](/packages/paymentsuite-paymentsuite) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)