> For the complete documentation index, see [llms.txt](https://docs.vpay.africa/woocommerce-plugin-specification/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vpay.africa/woocommerce-plugin-specification/3.-setup-and-configuration.md).

# 3. Setup and Configuration

This page describes the steps required to configure the VPay WooCommerce plugin for quick use.

1. Go to *WooCommerce > Settings* and click on the *Payments* tab.
2. You should see VPay listed along with your other payment methods. **Click *****Set Up**.*
3. On the next screen, configure the plugin. There is a selection of options on the screen. See descriptions for each one below.

   * *<mark style="color:blue;">Enable/Disable</mark>* - Tick this checkbox to Enable VPay on your store's checkout.
   * <mark style="color:blue;">Webhook Authentication Token</mark> - Tick the option to enable Webhook Authentication Token. <mark style="color:red;">NOTE</mark>: Copy the webhook URL provided and paste it into the Webhook input field on the VPay Dashboard. Save the changes.
   * *<mark style="color:blue;">Title</mark>* - Enter a caption for what your users see during checkout.
   * *<mark style="color:blue;">Description</mark>* - Provide a message that appears under the payment fields on the checkout page, explaining VPay and the available payment methods..
   * *<mark style="color:blue;">Test Mode</mark>* - Check this box to enable test mode. This allows you to test payments using SANDBOX details before going LIVE. Uncheck it when your store is ready to accept real payments.
   * *<mark style="color:blue;">Transaction\_Charge</mark>* - Specify the amount to be charged to the paying customer in addition to the order amount. This amount must be greater than 0 and shares the currency of the order amount.
   * *<mark style="color:blue;">Transaction\_Charge\_Type</mark>* - Either flat or percentage. This indicates how the payment total should be computed using the order amount and txn\_charge above. E.g. order amount = 1000, txn\_charge = 5, txn\_charge\_type = “percentage” then total = 1000 + (1000 \* 5%) = 1000 + 50 = 1050.
   * *<mark style="color:blue;">API Keys</mark>* - The next two text boxes are for your VPay API keys, which you can get from your VPay Dashboard. If you are in Test Mode in step four, then use your VPay SANDBOX API keys here. Otherwise, you can enter your VPay LIVE keys.
   * Click on ***Save Changes*** to update the settings.

That simple!

{% hint style="danger" %}
We *strongly* recommend that you set a Webhook URL on your VPay dashboard. This way, whenever a transaction is complete on your store, we'll send a notification to the Webhook URL, which will update the order and mark it as paid. You can set this up by using the URL in red at the top of the Settings page. Just copy the URL and save it as your webhook URL on your VPay dashboard under *Settings > Webhooks* tab.\
\
If you do not find VPay on the Payment method options, please go through the settings again and ensure that:<br>

1. You've checked the *"Enable/Disable"* checkbox
2. You've entered your *API Keys* in the appropriate field
3. You've clicked on *Save Changes* during setup
   {% endhint %}