> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitpayapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce POS Plugin

> Connect a card reader to your WooCommerce Point of Sale

## Overview

Here's a step-by-step guide on how to install and enable the HitPay plugin on WooCommerce for accepting in-person payments using a card reader.

<Note>If you are looking for payments, please refer to this [guide](/plugins/woocommerce).</Note>

## Ideal setup for this plugin

* If you have an existing WooCommerce store and your customers wish to make in-person card payments.
* If you are using a POS plugin for your WooCommerce and want to integrate a card reader. Works well with plugins like [wePOS](https://wordpress.org/plugins/wepos/) and [WooCommerce POS](https://wordpress.org/plugins/woocommerce-pos/).

### Requirements

Before you can start using this plugin, ensure you have the following:

1. Create a HitPay Account.
2. Activate card payment methods.
3. Order and set up your card reader.

## Procedure

<Steps>
  <Step title="Install HitPay WooCommerce Plugin">
    Search for HitPay in the keyword search field and install the plugin.

    <img src="https://mintcdn.com/hitpay/Xc8eVgaY1nmZMXnF/images/woocommerce/install.png?fit=max&auto=format&n=Xc8eVgaY1nmZMXnF&q=85&s=1fc414b3aa1e7a8856dbd8ab62718f87" alt="Search and Install Plugin" width="1440" height="809" data-path="images/woocommerce/install.png" />
  </Step>

  <Step title="Configure Plugin Settings">
    Navigate to `WooCommerce > Settings > Payments > Manage` next to the HitPay payment method.

    !\[Configur<img src="https://mintcdn.com/hitpay/Xc8eVgaY1nmZMXnF/images/woocommerce/manage.png?fit=max&auto=format&n=Xc8eVgaY1nmZMXnF&q=85&s=221ad3e6454ff0468b167097ad2a72a2" alt="Manage" width="1440" height="809" data-path="images/woocommerce/manage.png" />
  </Step>

  <Step title="Enter API Keys">
    Copy your API keys from your HitPay dashboard and paste them in the respective fields.

    <img src="https://mintcdn.com/hitpay/Xc8eVgaY1nmZMXnF/images/woocommerce/keys.png?fit=max&auto=format&n=Xc8eVgaY1nmZMXnF&q=85&s=495f0fb13d1ac0bb7f1badafd1ba9444" alt="Keys" width="1440" height="809" data-path="images/woocommerce/keys.png" />
  </Step>

  <Step title="Connect Card Reader">
    Link the card reader to your WooCommerce plugin by copying the terminal ID from your HitPay dashboard and pasting it into your WooCommerce plugin.

    Enable POS payments in your WooCommerce plugin settings.

    <img src="https://mintcdn.com/hitpay/MhRNiXk5E8-JnsDb/images/plugins/enable_pos_woocom.jpg?fit=max&auto=format&n=MhRNiXk5E8-JnsDb&q=85&s=8a6a0ead349eccdfe8481bcd8e4c20c9" alt="POS Payments" width="2062" height="1435" data-path="images/plugins/enable_pos_woocom.jpg" />

    Copy the terminal ID under `Point of Sale > Terminals` from your hitpay dashboard.

    <img src="https://mintcdn.com/hitpay/MhRNiXk5E8-JnsDb/images/plugins/copy_terminal_id.jpg?fit=max&auto=format&n=MhRNiXk5E8-JnsDb&q=85&s=3085501d84acc6818e18eca310ecb74a" alt="POS Payments" width="1970" height="1285" data-path="images/plugins/copy_terminal_id.jpg" />

    Paste the terminal ID in the Terminal Reader ID section and click `Save Changes`.

    <img src="https://mintcdn.com/hitpay/MhRNiXk5E8-JnsDb/images/plugins/paste_terminal_id.jpg?fit=max&auto=format&n=MhRNiXk5E8-JnsDb&q=85&s=1d48be203d8a0352ff083142b83bf6ac" alt="Save Changes" width="2212" height="1465" data-path="images/plugins/paste_terminal_id.jpg" />
  </Step>

  <Step title="Use the Card Reader for Checkout">
    A new `Card Reader` option will now appear in the payments section of your checkout page. Select this option and click `Place Order` to complete the transaction.

    <img src="https://mintcdn.com/hitpay/MhRNiXk5E8-JnsDb/images/plugins/checkout_card_reader.jpg?fit=max&auto=format&n=MhRNiXk5E8-JnsDb&q=85&s=4f4fc1307c05215b64a6b692a25f6586" alt="Checkout Option" width="3164" height="2190" data-path="images/plugins/checkout_card_reader.jpg" />

    <img src="https://mintcdn.com/hitpay/MhRNiXk5E8-JnsDb/images/plugins/checkout_reader_loading.jpg?fit=max&auto=format&n=MhRNiXk5E8-JnsDb&q=85&s=cd33b5eb5c38b59562c7201039d34b70" alt="Cashier View" width="3164" height="2190" data-path="images/plugins/checkout_reader_loading.jpg" />

    <img src="https://mintcdn.com/hitpay/MhRNiXk5E8-JnsDb/images/plugins/reader_success.jpg?fit=max&auto=format&n=MhRNiXk5E8-JnsDb&q=85&s=cd4e37491ffbeeb534f6b59a1f97370a" alt="Transaction Complete" width="1712" height="1784" data-path="images/plugins/reader_success.jpg" />
  </Step>
</Steps>

Congratulations! Your setup is complete, and your WooCommerce store is now integrated with the card reader. Customers can enjoy a seamless checkout experience, and you can manage payments through your HitPay dashboard.

## FAQs

<AccordionGroup>
  <Accordion title="When do I use the Cashier E-mail field?">
    The cashier's email is used to determine when to present the card reader option at the checkout:

    1. If the cashier's email is entered, the card reader option is only shown if the logged-in user is the cashier. This will also help to avoid showing the card reader option to your online checkout store users.
    2. If you have more than 1 POS setup in your physical store, the cashier email can be used to map the reader with the POS.
  </Accordion>

  <Accordion title="Does HitPay send an email after the WooCommerce order is confirmed">
    No, HitPay does not send an email confirmation to your customer if the payment is made through WooCommerce. This is because WooCommerce, by default, sends an email to your customer with the order details. To prevent duplicate emails, HitPay does not send an additional email to your customers. As a merchant, you will receive a payment alert email.
  </Accordion>

  <Snippet file="webhook-failed.mdx" />

  <Accordion title="How do I send WooCommerce test store access to HitPay?">
    If you are unable to resolve the WooCommerce issues, you can request HitPay support to help with your debugging. But before that, make sure the following checks are completed:

    * Ensure that your credentials are correct, both the API Key and Salt.
    * Ensure that you are testing with an amount greater than \$1 (or equivalent).
    * Make sure the webhook in the HitPay dashboard shows "Success."
      Please provide the following details to the HitPay team:

    1. Debug logs from your WooCommerce store.
    2. Admin access to your WooCommerce test store (Since our team will be debugging, please avoid sending access to your live store).
    3. SFTP access to your test store.
       You can send the details to [support@hit-pay.com](mailto:support@hit-pay.com) (Approximate debug time would be 3 to 5 business days).
  </Accordion>
</AccordionGroup>
