README

This repository contains the official PHP SDK for Rabo Smart Pay.

Rabo Smart Pay offers merchants an all-in-one solution to receive payments on your physical and online locations. It includes a dashboard that puts you in full control of your Rabo Smart Pay and all products included in it: Rabo OnlineKassa, payment terminals, Rabo PinBox, Rabo SmartPin, Retourpinnen, Rabo PinTegoed, Rabo Betaalverzoek Plus and payment brands such as: Maestro, V PAY, iDEAL, MasterCard, Visa and PayPal.

The PHP SDK allows PHP developers to integrate their web shop with Rabo Smart Pay to handle online payments. Note that besides using an SDK Rabo Smart Pay also provides other ways to integrate that may require less effort. More information on this topic can be found on the Developer Portal of Rabobank.

Detailed developer documentation on how to use the PHP SDK as well as contact information can be found in the SDK manual.

Release notes

Version 1.18.2

• Improved release notes
• Order status was reverted to /order/server/api/events/results/*
• Added GH Actions checks for PHP 8.4 and PHP 8.5
• Added GH Actions windows line ending check

Version 1.18.1

• Added a new SANDBOX_MODE environment variable

Version 1.18.0

• ⚠️ Manual base URL configuration required.

Updates the SDK to use the new api.pay.rabobank.nl domain and now appends the required omnikassa-api path internally. If you set the base URL yourself, ensure it contains only the domain (no path segments). See the examples below for the correct format.

Correct vs. Incorrect Configuration Examples

• Using the old paths will result in invalid URLs and failed API calls.
• Extended SDK to support Card On File functions
• Merged missing refunds features (PR#27)
• Added example integration with docker setup (separate README in example-integration).

Version 1.17.0

• Added support for setting the partnerReference id and user agent in the X-Api-User-Agent header.
• Added new optional shopperBankstatementReference field to order announcement

Version 1.16.0

• Extended SDK to support refunds.

Version 1.15.0

• Extended SDK to support refunds.
• Extended SDK to support transactions in order announcement result.

Version 1.14.0

• Extended SDK to support Sofort as a payment brand.

Version 1.13.0

• Extended SDK to retrieve a list of iDEAL issuers.
• Extended SDK to allow the iDEAL issuer to be passed in the order announcement.
• Extended SDK to allow the payment result page (also known as the 'thank-you' page) to be skipped in the payment process.
• Extended SDK to allow the name of the customer to be passed in the order announcement.
• Added support for PHP 8.0.
• Updated some dependencies to recent versions.

Version 1.12.1

• Fixed rounding problem (ROFE-4592).

Version 1.12.0

• First release via Packagist.
• Updated some dependencies.

Version 1.11.0

• Extended SDK to retrieve a list of configured payment brands.
• Allow the initiating party to be passed in the order announcement.

Version 1.9.0

• Fixes in the documentation.