PHPackages paynl/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. paynl/php-sdk ActiveLibrary[API Development](/categories/api) paynl/php-sdk ============= Pay. API client library for PHP. Pay. is an all-in-one European PSP offering 50+ payment methods both online and instore. 1.2.3(3w ago)979.7k↓25%41MITPHPPHP ^8.1 Since Feb 3Pushed 2w ago6 watchersCompare [ Source](https://github.com/paynl/php-sdk)[ Packagist](https://packagist.org/packages/paynl/php-sdk)[ RSS](/packages/paynl-php-sdk/feed)WikiDiscussions main Synced 2d ago READMEChangelog (10)Dependencies (48)Versions (37)Used By (1) [![](https://camo.githubusercontent.com/5c75d96c38b24c983eec9a63ba2a31737c29a55fb45c1f75df91a1a5f8a5803f/68747470733a2f2f7777772e7061792e6e6c2f75706c6f6164732f312f6272616e64732f6d61696e5f6c6f676f2e706e67)](https://camo.githubusercontent.com/5c75d96c38b24c983eec9a63ba2a31737c29a55fb45c1f75df91a1a5f8a5803f/68747470733a2f2f7777772e7061792e6e6c2f75706c6f6164732f312f6272616e64732f6d61696e5f6c6f676f2e706e67) PHP SDK ======= [](#php-sdk) Provides easy integration with Pay’s powerful payment platform, enabling online and instore payments with a wide range of local and international payment methods, including iDEAL, Bancontact, Apple Pay, PayPal, Klarna, credit cards, SEPA payments, and more. This PHP SDK makes it easy to integrate the powerful Pay. API into your integration to start transactions, retrieve payment statuses and process refunds directly from your website or platform. Have a look at our offer: [Country specific payment methods](https://www.pay.nl/en/payment-solutions-per-region) [Online card payments](https://www.pay.nl/en/online-cardpayments) [Buy Now Pay Later](https://www.pay.nl/en/buynow-paylater) [Giftcards and vouchers](https://www.pay.nl/en/giftcard-vouchers) [Instore payments](https://www.pay.nl/en/in-store-payments) --- Requirements ------------ [](#requirements) To use this PHP SDK, you’ll need: - A Pay. account (register here). - You can immediately use the API in sandbox mode. - API credentials which you will find in your Dashboard. - PHP 8.1–8.4 - JSON extension - CURL extension Once your account is set up, you can immediately start using the API in sandbox mode and enable payment methods for live transactions when ready. --- Installation ------------ [](#installation) ### Using Composer [](#using-composer) The recommended way to install the Pay. PHP SDK is via Composer: ``` composer require paynl/php-sdk ``` More info about installation [here](https://github.com/paynl/php-sdk/wiki/Install). --- Usage ----- [](#usage) ### Creating a transaction [](#creating-a-transaction) ``` use PayNL\Sdk\Model\Request\OrderCreateRequest; $payOrder = (new OrderCreateRequest()) ->setServiceId($serviceId) // Your SL-code: SL-####-#### ->setAmount(1.95) // Currency default in EURO. ->setReturnUrl('https://yourdomain/yourfinishpage.php') ->start(); echo $payOrder->getPaymentUrl(); ``` The response contains the order ID and redirect URL needed to forward the customer to the selected payment method. See also this minimum create order [example](https://github.com/paynl/php-sdk/blob/main/samples/OrderCreateMinimal.php) --- Documentation ------------- [](#documentation) For complete and up-to-date documentation, please explore our Developer Portal. Documentation is available in English. - API endpoints and parameters - Creating and managing transactions - Payment methods and statuses - Refunds and partial refunds - Webhooks (exchange URLs - Testing and debugging Detailed SDK usage examples can be found in this repository and in the official Developer Portal. --- Examples & Recipes ---------------------- [](#examples--recipes) The Pay. PHP SDK includes practical [examples](https://github.com/paynl/SDK-PHP/blob/main/samples) for common use cases, such as: - Starting a payment - Handling exchange URLs (webhooks) - Retrieving transaction details - Processing refunds - Working with recurring and deferred payment methods (where applicable) --- Upgrading --------- [](#upgrading) If you are upgrading from the [old SDK](https://github.com/paynl/sdk), please follow the [SDK Migration Guide](https://github.com/paynl/php-sdk/wiki/SDK-Migration-guide). --- Contributing ------------ [](#contributing) Contributions are welcome. Feel free to submit issues or pull requests to help improve the Pay. PHP SDK. --- Support ------- [](#support) Website: [Pay.nl](https://www.pay.nl/) Documentation: Developer.pay E-mail: [support@pay.nl](support@pay.nl) ### Health Score 57 — FairBetter than 98% of packages Maintenance96 Actively maintained with recent releases Popularity40 Moderate usage in the ecosystem Community22 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 91.5% 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 ~16 days Recently: every ~24 days Total 29 Last Release 17d ago Major Versions 0.2.6 → 1.0.02025-06-05 ### Community Maintainers ![](https://www.gravatar.com/avatar/3de4fdf653f1c9f2fd2fd25bb1ee8c5cfc05051f17a41759099e44fc47f6a089?d=identicon)[paynl](/maintainers/paynl) --- Top Contributors [![woutse](https://avatars.githubusercontent.com/u/6763638?v=4)](https://github.com/woutse "woutse (248 commits)")[![kevinverschoor](https://avatars.githubusercontent.com/u/61683999?v=4)](https://github.com/kevinverschoor "kevinverschoor (20 commits)")[![annevelden](https://avatars.githubusercontent.com/u/66354730?v=4)](https://github.com/annevelden "annevelden (2 commits)")[![StanvanHoorn](https://avatars.githubusercontent.com/u/9131625?v=4)](https://github.com/StanvanHoorn "StanvanHoorn (1 commits)") --- Tags phpapipaymentidealbancontactApple Paypaypay.nlpsp ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/paynl-php-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/paynl-php-sdk/health.svg)](https://phpackages.com/packages/paynl-php-sdk) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.5k5.9M737](/packages/sylius-sylius)[aws/aws-sdk-php AWS SDK for PHP - Use Amazon Web Services in your PHP project 6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[mollie/mollie-api-php Mollie API client library for PHP. Mollie is a European Payment Service provider and offers international payment methods such as Mastercard, VISA, American Express and PayPal, and local payment methods such as iDEAL, Bancontact, SOFORT Banking, SEPA direct debit, Belfius Direct Net, KBC Payment Button and various gift cards such as Podiumcadeaukaart and fashioncheque. 60216.0M84](/packages/mollie-mollie-api-php)[api-platform/core Build a fully-featured hypermedia or GraphQL API in minutes! 2.6k51.2M338](/packages/api-platform-core)[neuron-core/neuron-ai The PHP Agentic Framework. 2.0k656.1k38](/packages/neuron-core-neuron-ai) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)