PHPackages                             thanpa/buckaroo-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. thanpa/buckaroo-php-sdk

ActiveLibrary

thanpa/buckaroo-php-sdk
=======================

A PHP SDK for Buckaroo payment provider

037[1 issues](https://github.com/thanpa/buckaroo-php-sdk/issues)PHP

Since Feb 8Pushed 7y agoCompare

[ Source](https://github.com/thanpa/buckaroo-php-sdk)[ Packagist](https://packagist.org/packages/thanpa/buckaroo-php-sdk)[ RSS](/packages/thanpa-buckaroo-php-sdk/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (3)Used By (0)

Buckaroo API client for PHP [![Build Status](https://camo.githubusercontent.com/4feb108c06121d0f5b7608eecd6a5bd520cdcadf5560567d05b1ce13627d9ba7/68747470733a2f2f7472617669732d63692e636f6d2f7468616e70612f6275636b61726f6f2d7068702d73646b2e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/thanpa/buckaroo-php-sdk)
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#buckaroo-api-client-for-php-)

Currently only accepting [iDEAL](https://dev.buckaroo.nl/PaymentMethods/Description/ideal#top)

Requirements
------------

[](#requirements)

To use the Buckaroo API client, the following things are required:

- Get yourself a [Buckaroo account](https://www.buckaroo.nl/). Retrieve API keys.
- PHP >= 7.2

The client uses curl, so make sure that your PHP is installed with the curl extension.

Installation via Composer
-------------------------

[](#installation-via-composer)

- [Install Composer](https://getcomposer.org/doc/00-intro.md).
- Require the package in your project

```
composer require thanpa/buckaroo-php-sdk

```

Manual Installation
-------------------

[](#manual-installation)

Download the code from the repository (git).

Create an autoload file and include it in your project.

How to receive payments
-----------------------

[](#how-to-receive-payments)

To successfully receive a payment, these steps should be implemented:

1. Create a service that you need (for now only Ideal is available).
2. Create a transaction and add the service that you have created.
3. Send the customer to the provided redirect url.
4. Update the transaction status (Buckaroo will push information).

Initializing the Buckaroo API client, and setting your API key.

Getting started
---------------

[](#getting-started)

```
$buckaroo = new \Buckaroo\Buckaroo();
$buckaroo->setApiKeys("TEST_API_WEBSITE_KEY", "TEST_API_SECRET_KEY");
```

Executing a new transaction
---------------------------

[](#executing-a-new-transaction)

Creating a new payment.

```
$service = new \Buckaroo\Service\Ideal('Pay');
$service->setIssuer('ABNANL2A');
```

*You have to provide the type of the transaction (Pay or Refund)*

Then add the payment to a newly created transaction

```
$transaction
    ->addService($service)
    ->setAmount(10.00)
    ->setInvoice('#CG0001');
```

Finally, execution of the transaction.

```
$buckaroo->execute($transaction);
```

*After executing, the transaction key can be retrieved from the `$transaction->getKey()` method.*

Now that the transaction is ready, redirect the customer to the payment provider.

```
header("Location: " . $transaction->getRequiredAction()->getRedirectURL(), true, 303);
```

*This can be done with the 303 See Other http response code*

Retrieving an existing transaction
----------------------------------

[](#retrieving-an-existing-transaction)

This is pretty easy and you only need to call `getTransaction` method of the Buckaroo master class.

```
$transaction = $buckaroo->getTransaction('THIS-IS-THE-TRANSACTION-KEY');
```

Then the `$transaction` variable will hold a Transaction instance with all information populated in it.

Retrieving refund information
-----------------------------

[](#retrieving-refund-information)

This is also done easily with only a call to `getRefundInfo` method of the Buckaroo master class.

```
$refundInfo = $buckaroo->getRefundInfo('THIS-IS-THE-REFUND-TRANSACTION-KEY');
```

Then the `$refundInfo` variable will hold a RefundInfo instance with all information populated in it.

Making a transaction instance out of a Buckaroo push
----------------------------------------------------

[](#making-a-transaction-instance-out-of-a-buckaroo-push)

```
$transaction = $buckaroo->populateFromPush('{......}');
```

Once again you have a transaction instance, ready to be used for anything you need.

Support
-------

[](#support)

Contact: [www.thanpa.com](https://www.thanpa.com) —  — +30 2521105247

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f33d6bc425f50c428f13b96fef8bdfcab4d097ca06269ebc42fbf49f71219953?d=identicon)[thanpa](/maintainers/thanpa)

---

Top Contributors

[![NikosKalaitzis](https://avatars.githubusercontent.com/u/21362756?v=4)](https://github.com/NikosKalaitzis "NikosKalaitzis (43 commits)")

### Embed Badge

![Health badge](/badges/thanpa-buckaroo-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/thanpa-buckaroo-php-sdk/health.svg)](https://phpackages.com/packages/thanpa-buckaroo-php-sdk)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)