> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.paywithatoa.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce Payment Integration

> Accept Pay by Bank and card payments in WooCommerce with Atoa. Install the plugin, add your access secret and enable the gateway.

Woocommerce allows you to build and manage own online stores on top of WordPress. Atoa Pay is a payment gateway that allows customers to pay instantly for goods and services through their bank app using Open Banking. It works with all major UK banks.

## Steps to install and integrate Atoa plugin with woo-commerce

### 1. Installing the Atoa Business App

The Atoa Business app serves as the central hub for managing all your payments, APIs, integrations, and access tokens.

To get started, follow the steps below:

* **Download** the Atoa Business app from your device's <a target="_blank" href="https://play.google.com/store/apps/details?id=com.atoa.merchant" rel="noopener"><b>Play Store</b></a> or <a target="_blank" href="https://apps.apple.com/gb/app/atoa-business/id1620667507" rel="noopener"><b>Appstore</b></a>.
* <b>Sign up</b> with your business details to create an account. If you are new
  to Atoa, you must complete the onboarding and Know Your Business (KYB) process
  before you can begin using the app.
* Once signed in, access the homepage and locate the store icon on the top-left-hand side.
* Navigate to the settings tab within the app.
* Click on <b>"API Access"</b> to generate either the Production or Sandbox key based on your requirements.
* Simply paste your Homepage URL into the redirect URL field.

<Card type="tip" title="Important Notes" icon="paperclip">
  The Sandbox environment is exclusively intended for test payments with Atoa.
  Refer to the provided Sandbox guide for more detailed information.
</Card>

### 2 .Downloading and Installing the Atoa WordPress Plugin

Integrate the Atoa WordPress plugin into your e-commerce store by installing the [Atoa - WooCommerce](https://wordpress.org/plugins/atoa-pay/) plugin from the marketplace.

### 3. Setting up Atoa Pay on Your WordPress Account

<img src="https://mintlify.s3.us-west-1.amazonaws.com/atoa-payments-limited/images/Atoa_wordPress_account.png" width="512" height="336" alt="Atoa payment gateway settings in the WooCommerce plugin: enable the gateway, set the title, enter the access secret and toggle sandbox mode." />

**To set up Atoa Pay:**

* Access Settings or for WooCommerce users, navigate to WooCommerce > Payments > Atoa Pay.
* Click <b>"Manage"</b> and paste the API access key for Production or Sandbox.
  Thats it! Atoa is now ready to accept payments. For more help, visit docs.paywithatoa.co.uk or email us at **`hello@paywithatoa.co.uk`**.

<Note icon="shield-check" title="Webhook Signing (V2)">
  If you have enabled [V2 webhook signing](/api-reference/Webhook/v2-signing) in the Atoa Dashboard (**Settings → Webhooks**), paste your signing secret into the plugin's **Webhook Signing Key** field and save. This ensures the plugin can verify incoming webhook deliveries. Without this step, plugin webhooks will fail signature verification after V2 signing is enabled.
</Note>

**Congratulations! You have now successfully installed the Atoa WordPress plugin, and it is ready for use on your e-commerce store.**

**Atoa Sandbox environment guide**

<Card type="note" icon="paperclip" title="Please Note">
  Refer to atoa [**sandbox guide**](/atoa-sandbox) to simulate different
  scenarios, such as successful payments, failed payments, and pending payments.
</Card>

## Frequently asked questions (FAQs)

<AccordionGroup>
  <Accordion title="1. How Customers Pay with Atoa Pay?">
    <div>
      <ol>
        <li>
          The customer adds items to their cart and <b>proceeds</b> to checkout.
        </li>

        <li>
          At checkout, the customer see a list of payment methods, including{" "}
          <b>Atoa</b>.
        </li>

        <li>The customer selects Atoa and the checkout amount is shown.</li>

        <li>
          The customer is then presented with a list of their <b>bank apps.</b>
        </li>

        <li>
          The customer selects their bank app and is securely redirected to their
          bank app to complete the payment.
        </li>
      </ol>
    </div>
  </Accordion>

  <Accordion title="2. How Fast Will I Get the Money?">
    <div>
      <ol>
        <li>
          {" "}

          When a customer pays with Atoa Pay, the funds are sent directly from their
          bank account to your merchant account. This means that you will receive the
          money in a matter of seconds, not days or weeks.
        </li>

        <li>
          You can easily check all of your payments in the{" "}
          <b>Transactions section</b> of your Atoa Business app. This section
          shows the payment amount, the date and time the customer made it, and
          the customer’s bank account information.
        </li>
      </ol>
    </div>
  </Accordion>

  <Accordion title="3. How Much Will Atoa Charge Me?">
    <div>
      <ol>
        <li> Atoa charges a flat rate of 0.6% per transaction. There are no monthly charges  or setup fees. You can set up a direct debit to pay your transaction fees, or you can pay manually. To check your bill, go to My Account > Billing in the Atoa Business app. You can also manage your direct debit, usage, plan, and billing history in this section.</li>
        <li> Atoa sends bills on the last week of every month. The amount of your bill reflects your pricing plan and usage for the previous month. The invoice amount will be charged to your bank account on the 1st of each month.</li>
      </ol>
    </div>
  </Accordion>
</AccordionGroup>