mod_payment_buckaroo

Provide Buckaroo checkout and verified payment pushes through mod_payment.

Enable this module together with mod_payment. The checkout adapter accepts EUR. Select it with #payment_request{preferred_psp_module = mod_payment_buckaroo}.

Configure these site settings under System → Payment configuration, requiring use.mod_admin_config:

  • is_live: select live checkout instead of test; defaults to false.
  • website_key and secret_key: Buckaroo API credentials.
  • webhook_host: optional externally reachable origin, including protocol.
  • invoice_nr_prefix: generated invoice prefix, defaulting to INV.
  • services_excluded and services_selectable: comma-separated service codes controlling the methods offered by the checkout form.

Verified JSON pushes arrive at /buckaroo/webhook or the payment-specific /buckaroo/webhook/:payment_nr. Signed browser returns use /buckaroo/ready/:payment_nr. Incoming debit payments may be imported when mod_payment.accept_unknown_payments is enabled; credit transactions are not imported as incoming payments. Known payments support status synchronization. This adapter does not implement discovery polling for unknown payments.

Configuration

Configuration keys declared by this module. The defaults below are from the source code.

Module Key Type Default Description
mod_payment_buckaroo is_live boolean false Use the live Buckaroo checkout environment instead of the test environment.
mod_payment_buckaroo website_key binary <<>> Buckaroo website API key.
mod_payment_buckaroo secret_key binary <<>> Buckaroo secret API key.
mod_payment_buckaroo webhook_host binary <<>> Optional externally reachable webhook host, including protocol, for development or proxy setups.
mod_payment_buckaroo invoice_nr_prefix binary <<"INV">> Prefix for generated Buckaroo invoice numbers.
mod_payment_buckaroo services_excluded binary <<>> Comma separated Buckaroo service codes excluded from the payment form.
mod_payment_buckaroo services_selectable binary <<>> Comma separated Buckaroo service codes selectable on the payment form.

Observes

Notification

payment_psp_request

Notification

payment_psp_status_sync

Notification

payment_psp_view_url

Models

Controllers

Dispatch rules