# Configure Umbraco

## Step 1: Create Payment Method

The following steps are all handled through the Umbraco backoffice.

1. Navigate to **Settings > Commerce > Stores > {Store Name} > Payment Methods** section.
2. Select the **Create Payment Method** button to create a new payment method.
3. Choose **Buckaroo One Time Payment** from the list of available payment providers.

<figure><img src="/files/OjZxicb5Ob23mK3kCpDy" alt=""><figcaption><p>The "Create Payment Method" dialog in the Commerce section of the Umbraco CMS backoffice.</p></figcaption></figure>

## Step 2: Configure Payment Provider Settings

The following steps are handled within the payment method editor in the Umbraco backoffice.

1. Configure the standard payment method settings as required.
2. Configure the Buckaroo payment provider settings as follows:

| Name                       | Description                                                                                                                                                                                                                                                                                                                                           |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Continue URL               | The URL of the page to navigate to after payment is successful - e.g. `/continue/`                                                                                                                                                                                                                                                                    |
| Cancel URL                 | The URL of the page to navigate to if the customer cancels the payment - e.g. `/cart/`                                                                                                                                                                                                                                                                |
| Error URL                  | The URL of the page to navigate to if there is an error with the payment - e.g. `/error/`                                                                                                                                                                                                                                                             |
| Secret Key                 | **\[Required]** The Buckaroo secret key, can be found in your Buckaroo Plaza dashboard.                                                                                                                                                                                                                                                               |
| Secret Key                 | **\[Required]** The Buckaroo website key, can be found in your Buckaroo Plaza dashboard.                                                                                                                                                                                                                                                              |
| Webhook hostname overwrite | The hostname where the buyer does checkout is a part of Buckaroo's payload signature. If you rewrite the host header for some reasons and make the hostname that your server sees different from the hostname where the buyer does checkout, you need to set this to the hostname where the buyer does checkout. Enter hostname only - e.g. `umbraco` |
| Enable test mode           | Toggle indicating whether this provider should run in test mode.                                                                                                                                                                                                                                                                                      |


---

# 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-umbraco.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.