# Install Optty

Once you’ve logged into the admin portal of your store, click **Plugins** on the left hand menu and then **Add New at the top of the page**.

<figure><img src="/files/WJOtqcrr8KuMMPXk9u49" alt=""><figcaption></figcaption></figure>

Then search for **Optty** and click on the **\[Install Now]** button.&#x20;

<figure><img src="/files/ozoPuwTnWhYPItTCeFfu" alt=""><figcaption></figcaption></figure>

Once it's installed, the **\[Install Now]** button will turn into an **\[Activate]** button, which you will now need to click.&#x20;

Next, you'll need to configure the Optty plugin. You can get to the settings page by clicking **\[Settings]** under **WooCommerce** in the left hand menu, and then selecting the **\[Payments]** tab at the top of the page.&#x20;

<figure><img src="/files/esnxXMEsN5DL0HmlO9DQ" alt=""><figcaption></figcaption></figure>

On this page, the first field is the description which will appear on your checkout page.

You will also need to input the Authentication URL, Merchant API URL and Widget SDK URL, which you can find below. Choose either the Sandbox or Production environment depending upon whether you're testing or ready to launch.&#x20;

### Update Cart and Checkout Widget

In this step, we will link the Optty checkout and cart to your site. Go to Pages on the side navigation bar. For the Cart Page and Checkout Page, go through the two following steps, remove all content on the page add a shortcode block and enter the following, for the checkout page enter "\[woocommerce\_checkout]" and for the cart page enter "\[woocommerce\_cart]".

To add a shortcode block click the blue "+" button in the top left and select shortcode.

The final page for both should look like the below image.

<figure><img src="/files/YWJMJQC41khCfSvMdAFF" alt=""><figcaption></figcaption></figure>

### Sandbox / Testing environment&#x20;

```
Authentication: https://auth.qa.optty.com/token

Merchant URL: https://api.qa.optty.com

Widget SDK URL: https://widgets.qa.optty.com/widget-loader.js
```

### Production URL&#x20;

```
Authentication: https://auth.optty.com/token

Merchant URL: https://api.optty.com

Widget SDK URL: https://widgets.optty.com/widget-loader.js
```

Finally, input your **Client ID, Client Secret,** and **Hash Secret.**&#x20;

For the sandbox environment, these can be found in your welcome email under Optty API Credentials. Please note that the **Hash Secret** may also be called **hmac** or r**edirect secret**.&#x20;

Production credentials are provided to you once you’ve completed the onboarding process by one of the Optty team members.&#x20;

Click **\[Save changes]** once all of the information has been entered.&#x20;

In your checkout, you will now have Optty Payment as an additional payment method (without any APM options, until you add them).&#x20;

![](/files/kNCMy0P5bLPzs2Nj7tMw)

If you want to change the name “Optty Payment”, you’ll need to do so in the source code.&#x20;

On your server, in your Wordpress folder,  you need to navigate to **/wp-content/plugins/optty/src/classes** and open the file “**class-optty-gateway.php**”.&#x20;

Find the line that says:

**$this->title         = 'Optty Payment';**

And change the words between the apostrophe’s to what you would like it to say.&#x20;

If you would like to change or remove the image, find the line that says:

**$this->icon = ‘<https://widgets.optty.com/images/optty/black/optty-sub.svg>';**

And change the URL between the apostrophe’s to a new image or leave it blank to remove the image entirely.

{% hint style="danger" %}
If you encounter any CORS-related errors while loading the Optty widget on your site after completing the setup, please ensure your domain is added to the "Whitelisted Domains" in the Optty Universal Payment Platform (UPP). This option can be found under the "Account Details" section. \
\
Please ensure that you use the domain with **HTTPS** only, and do not include a trailing slash at the end of the URL (ie: <https://www.yourdomain.com>).
{% endhint %}

***

{% hint style="info" %}
Once you have completed these steps and for the right payment options to appear at your checkout, you will need to add them in the Optty Universal Payment Platform (UPP) by performing steps as shown in this [Support Article](https://articles.optty.com/optty-retail-control-panel/add-new-buy-now-pay-later).
{% 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.optty.com/platforms/woocommerce/install-optty.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.
