# 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](https://3206860037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8zV7PYqNxSkuGGGYa3P%2Fuploads%2Fgit-blob-adfa2c453cc3800c1ff2723b4c8f974648cd2d89%2Fquickpay_signup.png?alt=media)

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

![The login form to the QuickPay portal.](https://3206860037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8zV7PYqNxSkuGGGYa3P%2Fuploads%2Fgit-blob-b3951b6e1c73dbdde0a295d16cb9cae06c765455%2Fquickpay_signin.png?alt=media)

## 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](https://3206860037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8zV7PYqNxSkuGGGYa3P%2Fuploads%2Fgit-blob-0a615032715d0f415e698ae002dc276f2f6bfb7e%2Fquickpay_portal.png?alt=media)

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