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.0(2mo ago)541.2k—0.7%4[1 PRs](https://github.com/paynl/php-sdk/pulls)1MITPHPPHP ^8.1 Since Feb 3Pushed 2mo ago4 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 1mo ago READMEChangelog (10)Dependencies (24)Versions (31)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 52 — FairBetter than 96% of packages Maintenance86 Actively maintained with recent releases Popularity37 Limited adoption so far Community18 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 92.3% 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 ~15 days Recently: every ~10 days Total 25 Last Release 68d 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 (240 commits)")[![kevinverschoor](https://avatars.githubusercontent.com/u/61683999?v=4)](https://github.com/kevinverschoor "kevinverschoor (18 commits)")[![annevelden](https://avatars.githubusercontent.com/u/66354730?v=4)](https://github.com/annevelden "annevelden (2 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 [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. 60014.4M62](/packages/mollie-mollie-api-php)[mollie/laravel-mollie Mollie API client wrapper for Laravel & Mollie Connect provider for Laravel Socialite 3624.1M28](/packages/mollie-laravel-mollie)[mollie/magento2 Mollie Payment Module for Magento 2 1121.6M10](/packages/mollie-magento2)[theodo-group/llphant LLPhant is a library to help you build Generative AI applications. 1.5k311.5k5](/packages/theodo-group-llphant)[checkout/checkout-sdk-php Checkout.com SDK for PHP 553.3M7](/packages/checkout-checkout-sdk-php)[mage2pro/stripe Stripe integration with Magento 2 605.3k](/packages/mage2pro-stripe) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)