Skip to content

SDK Migration guide

Wouter Jonker edited this page Jan 23, 2026 · 8 revisions

PHP SDK Migration Guide

This documentation describes how to migrate from the old SDK to this PHP-SDK.

Each section focuses on a specific feature and is based on the official SDK samples.


Available migration guides

Step-by-step migration of starting a payment. Start payment migration

How to migrate the exchange / webhook handling. Exchange migration

How to migrate capturing an authorized payment. Capture migration

How to migrate refunds. Refund migration

How to retrieve transaction or order details using the new SDK. Get transaction migration

How to retrieve available payment methods using the new SDK. Payment methods migration


General notes

  • The old SDK uses config.php for configuration.
  • The new SDK uses the global configuration via Config or config/config.global.php.
  • The exception \Paynl\Error\Error no longer exists and is replaced by PayNL\Sdk\Exception\PayException.

Clone this wiki locally