FAQ
Answers to common questions about the Buckaroo Laravel Wrapper.
Something not working? See Troubleshooting.
Getting started
Should I use the wrapper or the PHP SDK?
Use the wrapper in a Laravel application. It stores transactions, receives and verifies push messages, and fires events, so you write less code.
Use the PHP SDK in a PHP application without Laravel, or when you want to build all of that yourself.
Should I use the wrapper or a plugin?
Use a plugin if your store runs on a supported e-commerce platform. It needs no development. See Plugins and apps. The wrapper is for custom Laravel applications.
Does the wrapper cost anything?
No. The package is free and open source under the MIT license. Transactions are charged according to your Buckaroo contract.
Which Laravel and PHP versions are supported?
The current requirements are on the Laravel Wrapper page and on Packagist.
Where do I find my store key and secret key?
In Plaza under Settings → API keys. The store key goes in BPE_WEBSITE_KEY. See Configuration.
Do I need to install the PHP SDK separately?
No. Composer installs the PHP SDK together with the wrapper.
Payments
Which payment methods can I use?
The same methods as the PHP SDK, provided the method is active for your store in Plaza. See the service code list and Payment methods.
How do I know whether a payment succeeded?
Listen to the PayTransactionCompleted event and check the status of the transaction. The wrapper fires it after it has processed the push message. See Push messages and events.
Do I have to build the push handler myself?
No. The wrapper registers the push route, verifies the signature and updates the stored transaction. You only write an event listener.
Where are my transactions stored?
In the buckaroo_transactions table, through the BuckarooTransaction model. You can extend the model with your own. See Order management.
Can I issue refunds?
Yes, in full or in part, with RefundService. See Order management.
Can I use the PHP SDK functions that the wrapper has no service for?
Yes. Buckaroo::api() and the buckaroo() helper give you the PHP SDK client, so everything in the PHP SDK is available.
Testing and support
How do I test without real payments?
Set BPE_MODE=test. All requests then go to the Buckaroo test environment. See Test and go live.
Where do I report a bug or request a feature?
Open an issue in the repository. Pull requests are welcome too.
How do I know when a new version is released?
Watch the releases page on GitHub.
Updated about 7 hours ago