# Configure QuickPay

## Step 1: Sign up & Sign in

If you haven't done so yet, head over to the [QuickPay portal](https://manage.quickpay.net/create-user) to register for a QuickPay account.

![QuickPay Signup](/files/muSNP3KGwnFwl6O57k4E)

Or [login to the QuickPay portal](https://manage.quickpay.net/) if you already have an account.

![The login form to the QuickPay portal.](/files/6QV6DEcCBeRlV3IRlRnF)

## Step 2: API Keys

In order for Umbraco Commerce to communicate with QuickPay securely we need to retrieve a series of API keys used for authentication.

The keys can be found under **Settings > Integration** in the QuickPay portal.

You will need the following keys:

* Private key of your account
  * You'll find that in the first option, where your account name is
* Api key of the API user
  * The second option, right below the Private key
* Merchant id
  * This is written below your account name
* Agreement id
  * This is written below API user, Payment Window and your user account name

![QuickPay Integration Keys](/files/rvUa7yXAGgu00OtjbNDn)

## Step 3: Webhook

In order for QuickPay to notify Umbraco Commerce of a successful transaction, QuickPay makes use of webhook technology. This enables sending notifications of changing transaction statuses directly between the two platforms.

Webhooks ensure that Umbraco Commerce will always be notified of status changes, even if the customer decides not to return to the store.

Registration of webhook notifications is handled as part of the payment request using the Umbraco Commerce callback URL.

The following is an example of such a callback URL:

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

When using this, be sure to replace the parameters in the curly brackets with the corresponding values taken from your store.


---

# 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/quickpay/configuring-quickpay.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.