Answers to common questions about the Buckaroo PHP SDK.

Something not working? See Troubleshooting.


Getting started

Should I use the SDK or a plugin?

Use a plugin if your store runs on a supported e-commerce platform. It needs no development. See Plugins and apps.

Use the SDK for a custom application or a platform without a Buckaroo plugin. For Laravel, use the Laravel Wrapper, which is built on this SDK.

Does the SDK cost anything?

No. The SDK is free and open source under the MIT license. Transactions are charged according to your Buckaroo contract.

Which PHP versions are supported?

The current requirements are on the PHP SDK page and in the repository's README.

Where do I find my store key and secret key?
Can I use the SDK in the browser?

No. The SDK runs on your server only, because it signs requests with your secret key. To collect card data in the browser, use the JS Client Side Encryption SDK or Hosted Fields together with the SDK.


Payments

Which payment methods can I use?

The Buckaroo payment methods, provided the method is active for your store in Plaza. The repository has the service code list, and Payment methods has the details for each method.

Why do field names differ from the API reference?

The API reference describes the raw JSON request and uses PascalCase. The SDK builds that request for you and takes camelCase field names, such as amountDebit. It ignores names it does not recognise. See Payments.

How do I know whether a payment succeeded?

From the push message that Buckaroo sends to your push URL when the status changes. Do not rely on the customer returning to your store. See Push messages.

Can I poll the status instead of handling push messages?

You can look up a transaction with $buckaroo->transaction($key)->status(), but use that for reconciliation and support. Push messages are faster and are not subject to rate limiting.

Can I issue refunds?

Yes, in full or in part, with the transaction key of the original payment. See Order management.

Why is there no Riverty service code?

Riverty uses the service code afterpay, which was the method's name before it was renamed.


Testing and support

How do I test without real payments?

Create the client in test mode. All requests then go to the Buckaroo test environment. See Test and go live.

Where can I find more examples?

In the example folder of the repository, with a runnable script for each payment method and additional service.

Where do I report a bug or request a feature?

Open an issue in the repository. Pull requests are welcome too. Read the contribution guidelines first.

How do I know when a new version is released?

Watch the releases page on GitHub. The changelog lists what changed in each version.



Did this page help you?