# Configure Buckaroo

## Step 1: Sign up & Sign in

You can sign up in 2 different ways:

1. For a business account, head over to the [Buckaroo site](https://www.buckaroo.eu/large-corporations/start) to register for a Buckaroo account.
2. For a test account, you can fill in a request form: <https://www.buckaroo.eu/large-corporations/solutions/request-form>

### Test & Live mode

When logged in to the [Buckaroo Dashboard](https://plaza.buckaroo.nl/) it is important to know that there are two modes you can view data and perform tasks under. These are **Test mode** and **Live mode**:

* **Test mode** allows you to perform test transactions to ensure your solution is set up correctly.
* **Live mode** is where real-life transactions will take place.

In order to enable test mode, you can check the [Buckaroo documentation](https://docs.buckaroo.io/docs/test-transactions#how-to-make-a-test-transaction).

<figure><img src="/files/f6ihuEjyDjYfqVIKX1Yf" alt=""><figcaption><p>Enable test mode</p></figcaption></figure>

For each of these modes, multiple settings need to be configured.

## Step 2: Website key and secrets

In order for Umbraco Commerce to communicate with Buckaroo securely, we need to generate an API key that Umbraco Commerce can use to authenticate with.

### Website key

1. Go to [Buckaroo Dashboard](https://plaza.buckaroo.nl/).
2. Then head to Settings > Websites > General tab to find the website key:

   <figure><img src="/files/BXToaFRuuGRtYmOUq7IP" alt=""><figcaption><p>Website key</p></figcaption></figure>

### Secret key

1. Go to [Buckaroo Dashboard](https://plaza.buckaroo.nl/).
2. Then head to Settings > Secret key to find the secret key:

   <figure><img src="/files/e5PejwIGz3nqhckQ7GdZ" alt=""><figcaption><p>Secret key in the Buckaroo Dashboard</p></figcaption></figure>

## Step 3: Webhook

For Buckaroo to notify Umbraco Commerce of a transaction, Buckaroo makes use of webhook technology to send notifications of the changing transaction statuses. By using webhooks it ensures that the system will always be notified of these status changes. This is also the case if a customer decides not to return to the store once a transaction is complete.

When generating a payment request form, Umbraco Commerce sets the callback URL to the value below automatically:

```bash
https://{store_domain}/umbraco/commerce/payment/callback/buckaroo-checkout/{payment_method_id}/
```

1. Go to [Buckaroo Dashboard](https://plaza.buckaroo.nl/).
2. Then head to Settings > Websites > Push settings > Scroll. Then `Select push content type` and set it to `json`.

{% hint style="info" %}
When testing the webhook, you might use a service like ngrok to forward requests from a public domain to your localhost server. Then you need to set `Webhook hostname for test mode` value to be the public domain in order for it to work.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-commerce-payment-providers/buckaroo/configuring-buckaroo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.