- API
- Een JSON-gateway naar de Buckaroo Payment Engine, met twee soorten aanroepen: Transaction en DataRequest. Live is checkout.buckaroo.nl/json, test is testcheckout.buckaroo.nl/json. Tot 100 verzoeken bundel je in één aanroep via de Batch API.
- Authenticatie
- HMAC in de Authorization-header: een HMAC-SHA256 met je geheime sleutel over websitekey, methode, URI, tijdstempel, nonce en de Base64 van de MD5 van de body. Buckaroo heeft een debugger die elke tussenstap laat zien.
- Sleutels
- Elke website heeft een eigen websitekey van 10 tekens, maar er is één geheime sleutel per account, voor al je websites; vervang je die, dan moet elke website mee. Een nieuwe website maak je niet zelf aan, die vraag je aan via het contactformulier in Plaza.
- Limieten
- 400 verzoeken per 5 seconden per IP-adres, ongeveer 80 per seconde. Daarboven volgt HTTP 429; voor grote aantallen wijst Buckaroo naar de Batch API.
- Testen
- Op testcheckout.buckaroo.nl maak je testtransacties, als je die per websitekey hebt aangezet; op verzoek maakt Buckaroo een apart testaccount. De eerste 100 testtransacties zijn gratis, daarna kost een testtransactie €0,03.
- Pushberichten
- Een push gaat naar je push-URL bij elke statuswijziging en telt als geslaagd bij HTTP 200. Lukt dat niet, dan probeert Buckaroo het opnieuw, met in totaal 11 pogingen in 18 uur. Een push kan dubbel en in een andere volgorde komen, en draagt een brq_signature die je met je geheime sleutel controleert.
- IP-adressen van pushes
- De pushpagina noemt vier IP-adressen waar pushes vandaan komen, en de PHP SDK van Buckaroo raadt aan die op een allowlist te zetten. Ik controleer daarnaast altijd de handtekening.
- Betaalmethoden
- Meer dan 40 betaalmethoden en 8 valuta. Elke methode moet voor je account zijn geactiveerd voordat je hem in een plug-in of via de API gebruikt.
- Kosten bij Buckaroo
- Voor de API vraagt Buckaroo niets, en de plug-ins zijn gratis: je betaalt per geslaagde transactie. De online prijzen zijn exclusief btw, zoals €0,30 per transactie voor iDEAL | Wero. De API-voorwaarden houden de mogelijkheid open om later wel te rekenen.
- Voorwaarden en ondersteuning
- De API is alleen voor geaccepteerde merchants, en je mag alleen de nieuwste versie gebruiken; Buckaroo kan de API zonder aankondiging wijzigen. Over hulp verschillen de pagina’s: de API-voorwaarden zeggen dat Buckaroo naast de documentatie geen ondersteuning geeft, de partnerpagina belooft 24/7 support en integratiehulp.
- Vergunning en gegevens
- Buckaroo is een betaalinstelling met een vergunning van De Nederlandsche Bank en wordt elk jaar getoetst tegen PCI DSS. Volgens de verwerkersovereenkomst verwerkt Buckaroo persoonsgegevens alleen in de EER.
- Klanten
- De cijfers van Buckaroo zelf lopen uiteen: meer dan 54.000 organisaties op de pagina over het bedrijf en in de PHP SDK, meer dan 55.000 klanten in het persbericht van 1 september 2026.
- SDK’s
- Buckaroo onderhoudt SDK’s voor PHP, Node.js, .NET en Python.