This section helps you set up your integration with Rabo Smart Pay. You’ll learn about prerequisites, available integration options (SDK, plugins, or direct API), how to configure your sandbox environment, and the steps to go live in production.

Prerequisites

Login or request Rabo Smart Pay
1. Before you begin development, you’ll need a Rabo Smart Pay contact and access to the dashboard. You can request Rabo Smart Pay or log in to the dashboard here.
Request Rabo OnlineKassa & pass webshop approval
1. In the dashboard, you must request Rabo OnlineKassa. Once this request is submitted, Rabo Smart Pay will review your webshop. Full Rabo OnlineKassa functionality will only be enabled after this check has been successfully completed. You can read more about the requirements and approval process here.

Integration options

To start using our product, you need to integrate your webshop with the Online Payment API. There are several ways to connect your webshop to the Rabo Smart Pay API, depending on your preference:

Plugins: For popular platforms like Magento and WooCommerce, we offer ready-to-use plugins. These can be installed and configured easily, without any coding.
SDKs: For PHP, .NET, and Java, we provide software development kits (SDKs) that simplify integration by using our API.
Custom Integration: You can also connect your webshop directly using our API specifications.

Sandbox setup

If you're ready to start building your integration with Rabo Smart Pay, our sandbox environment is the perfect place to begin. It closely mimics communication with our production APIs, allowing you to safely test your setup, simulate transactions, and validate responses, before going live.

Retrieve Your Sandbox Webkeys
1. You’ll find the refresh token and signing key in the Rabo Smart Pay dashboard, which are required to securely connect to the sandbox environment. Go to: Self Service → My Business → Manage Webshop → Actions → Integration Settings → Actions → Copy Sandbox Webkeys
2. If you don’t have dashboard access, please contact our Support Team.
Set your sandbox webhook URL
1. Create a webhook in your backend that can receive notifications.
2. Register the sandbox webhook endpoint in the dashboard: Log in to your Rabo Smart Pay dashboard and navigate to: Self Service → My Business → Manage Webshop → Actions → Integration Settings → Edit Webhooks.
Start building your integration

Begin your integration by connecting with our endpoints. To guide you through the integration, we provide the following documentation:
1. API Integration guide: The Integration Guide explains how to use our endpoints effectively. It includes details on authentication, payments, refunds, and shopper information, along with examples and best practices.
2. Sandbox Testing Guide: All endpoints support sandbox testing, either with stubbed responses or through a dynamic test environment. The Sandbox Testing Guide outlines available test scenarios and shows you how to simulate specific responses before going live.

Go live

Once you've successfully tested your integration in the sandbox environment and confirmed that all connections work as expected, you're ready to go live. Here's how to make the switch:

Update the API Base URL
1. Change the base URL in your integration from the sandbox domain: https://api.pay-sandbox.rabobank.nl to the production domain: https://api.pay.rabobank.nl
Replace Sandbox Credentials with Production Credentials
1. Log in to the Rabo Smart Pay dashboard and navigate to: Self Service → My Business → Manage Webshop → Actions → Integration Settings → Actions → Copy Webkeys
2. Here, you’ll find your production refresh token and signing key. Use the production refresh token to request an access token via the production endpoint.
Set your production webhook URL
1. Create a webhook in your backend that can receive notifications.
2. Register the production webhook endpoint in the dashboard: Log in to your Rabo Smart Pay dashboard and navigate to: Self Service → My Business → Manage Webshop → Actions → Integration Settings → Edit Webhooks.