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

# Payment integrations

> Connect Stripe, PayPal, Square, NMI, Authorize.net, Razorpay, Adyen, QuickBooks, and other payment processors to the HoopAI Platform.

The HoopAI Platform supports a wide range of payment gateways. Connect one or more processors to accept card payments, ACH debits, digital wallets, and more — both online and in person.

Navigate to **Payments → Payment Integrations** (via the **Integrations** option in the upper-right of the Payments tab) to get started.

<Frame caption="Payment Integrations — available, connected, and default payment providers">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/CS0bauo8Tbx8zu0U/images/payments-payment-integrations-overview.png?fit=max&auto=format&n=CS0bauo8Tbx8zu0U&q=85&s=ce98c1752c5d47c04ae139a9be61cc71" alt="Payment integrations" width="1611" height="736" data-path="images/payments-payment-integrations-overview.png" />
</Frame>

### How the integrations screen is organized

The Payment Integrations page is divided into three sections:

1. **Default provider** — the standard gateway used for all payment collection
2. **Connected providers** — additional integrated gateways with a **Manage** button
3. **Available providers** — gateways not yet connected, with a **Connect** button

<Note>
  **Stripe is strongly recommended** as your primary payment gateway. It unlocks the full feature set including recurring invoices with autopayment, ACH debit, Apple Pay, Google Pay, and subscription management. Other gateways have limited feature availability.
</Note>

## Supported integrations

<CardGroup cols={2}>
  <Card title="Stripe" icon="stripe">
    Full-featured: invoices, subscriptions, ACH, Apple Pay, Google Pay, Stripe Connect.
  </Card>

  <Card title="PayPal" icon="paypal">
    Accept PayPal wallet payments and card payments via PayPal's checkout.
  </Card>

  <Card title="Square" icon="square">
    In-person and online payments with Square hardware support.
  </Card>

  <Card title="NMI" icon="credit-card">
    Network Merchants Inc. — a full gateway with advanced fraud tools.
  </Card>

  <Card title="Authorize.net" icon="credit-card">
    Enterprise-grade gateway with strong fraud detection and reporting.
  </Card>

  <Card title="Razorpay" icon="credit-card">
    Payments for India-based businesses; supports UPI, cards, and net banking.
  </Card>

  <Card title="Adyen" icon="credit-card">
    Global payment platform for enterprise merchants.
  </Card>

  <Card title="QuickBooks" icon="book">
    Sync invoices and payments to QuickBooks for accounting reconciliation.
  </Card>

  <Card title="Wave Accounting" icon="wave-square">
    Sync invoices to Wave Accounting for bookkeeping.
  </Card>

  <Card title="Manual methods" icon="hand-holding-dollar">
    Accept cash, check, bank transfer, or any custom payment method.
  </Card>
</CardGroup>

***

<Frame caption="Stripe integration — connect your Stripe account to unlock ACH, Apple Pay, Google Pay, and subscription management">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/wwsLp7XUMAI9CtMc/images/payments-transactions-overview.png?fit=max&auto=format&n=wwsLp7XUMAI9CtMc&q=85&s=d87aea86dd24967c19a82f78fbc92389" alt="Stripe integration" width="1598" height="482" data-path="images/payments-transactions-overview.png" />
</Frame>

***

## Stripe integration

Stripe is the recommended primary gateway for the HoopAI Platform. It enables the broadest set of payment features.

<Steps>
  <Step title="Open integrations">
    Go to **Payments → Payment Integrations** and click **Connect** next to Stripe.
  </Step>

  <Step title="Sign in to Stripe">
    You'll be redirected to Stripe. Sign in to your existing Stripe account or create a new one.
  </Step>

  <Step title="Authorize the connection">
    Review the permissions and click **Connect**. You'll be redirected back to the HoopAI Platform.
  </Step>

  <Step title="Verify the connection">
    The Stripe integration tile will show a green "Connected" indicator. Your Stripe account ID is displayed for confirmation.
  </Step>
</Steps>

### Stripe features unlocked

| Feature                                | Available with Stripe |
| -------------------------------------- | --------------------- |
| Card payments (Visa, Mastercard, Amex) | Yes                   |
| ACH debit                              | Yes                   |
| Apple Pay                              | Yes                   |
| Google Pay                             | Yes                   |
| Recurring invoices with autopayment    | Yes                   |
| Subscriptions                          | Yes                   |
| Refunds                                | Yes                   |
| Test mode                              | Yes                   |

***

***

## PayPal integration

<Steps>
  <Step title="Open integrations">
    Go to **Payments → Payment Integrations** and click **Connect** next to PayPal.
  </Step>

  <Step title="Log in to PayPal">
    You'll be redirected to PayPal to log in with your business account credentials.
  </Step>

  <Step title="Grant permissions">
    Approve the requested permissions so the HoopAI Platform can process payments on your behalf.
  </Step>

  <Step title="Return to confirm">
    After approval, you're redirected back and the PayPal integration shows as connected.
  </Step>
</Steps>

***

***

## Square integration

<Steps>
  <Step title="Open integrations">
    Go to **Payments → Payment Integrations** and click **Connect** next to Square.
  </Step>

  <Step title="Log in to Square">
    Sign in to your Square account and authorize the connection.
  </Step>

  <Step title="Select your location">
    If you have multiple Square locations, select the one to connect.
  </Step>

  <Step title="Confirm">
    Return to the HoopAI Platform. Square is now connected and ready to process payments.
  </Step>
</Steps>

***

***

## NMI (Network Merchants Inc.) integration

NMI is a full-service payment gateway with advanced fraud detection and recurring billing support.

<Steps>
  <Step title="Gather your NMI credentials">
    Log in to your NMI merchant dashboard and locate your **API key** and **gateway ID**.
  </Step>

  <Step title="Open integrations">
    Go to **Payments → Payment Integrations** and click **Connect** next to NMI.
  </Step>

  <Step title="Enter credentials">
    Paste your NMI API key and any additional required fields (security key, gateway ID).
  </Step>

  <Step title="Test the connection">
    Use the built-in test transaction to verify the connection is working before going live.
  </Step>

  <Step title="Save">
    Click **Save**. NMI is now active on your account.
  </Step>
</Steps>

***

***

## Authorize.net integration

Authorize.net is an enterprise-grade gateway widely used by established businesses.

<Steps>
  <Step title="Gather your Authorize.net credentials">
    Log in to your Authorize.net merchant portal and note your **API Login ID** and **Transaction Key**.
  </Step>

  <Step title="Open integrations">
    Go to **Payments → Payment Integrations** and select Authorize.net.
  </Step>

  <Step title="Enter credentials">
    Enter your API Login ID and Transaction Key. Optionally enter your **Signature Key** for enhanced webhook verification.
  </Step>

  <Step title="Choose live or sandbox">
    Toggle between **Live** and **Sandbox** mode for testing.
  </Step>

  <Step title="Save">
    Click **Save**. The integration is now active.
  </Step>
</Steps>

***

***

## Razorpay integration

Razorpay supports businesses operating in India, offering UPI, net banking, cards, and wallets.

<Steps>
  <Step title="Get your Razorpay API keys">
    Log in to your Razorpay dashboard and go to **Settings → API Keys**. Generate a key pair if you haven't already.
  </Step>

  <Step title="Open integrations">
    Go to **Payments → Payment Integrations** and click Razorpay.
  </Step>

  <Step title="Enter Key ID and Secret">
    Paste your Razorpay **Key ID** and **Key Secret**.
  </Step>

  <Step title="Save">
    Click **Save**. Razorpay is now connected.
  </Step>
</Steps>

***

***

## Adyen integration

Adyen is a global enterprise payment platform. Contact your Adyen account manager for merchant credentials before connecting.

<Steps>
  <Step title="Get Adyen credentials">
    From your Adyen Customer Area, note your **Merchant account name**, **API key**, and **Client key**.
  </Step>

  <Step title="Open integrations">
    Go to **Payments → Payment Integrations** and select Adyen.
  </Step>

  <Step title="Enter credentials">
    Fill in the required Adyen API fields.
  </Step>

  <Step title="Save">
    Click **Save**.
  </Step>
</Steps>

***

***

## QuickBooks integration

Syncing with QuickBooks keeps your invoices and payment records in sync with your accounting software automatically.

<Steps>
  <Step title="Open integrations">
    Go to **Payments → Payment Integrations** and click **Connect** next to QuickBooks.
  </Step>

  <Step title="Sign in to QuickBooks">
    Authenticate with your QuickBooks Online account.
  </Step>

  <Step title="Authorize">
    Grant the HoopAI Platform permission to read and write QuickBooks data.
  </Step>

  <Step title="Configure sync">
    Choose which data to sync — invoices, payments, customers, and products.
  </Step>

  <Step title="Save">
    Click **Save**. Going forward, invoices created in the HoopAI Platform will sync to QuickBooks automatically.
  </Step>
</Steps>

***

***

## Apple Pay and Google Pay

Apple Pay and Google Pay are digital wallets that let customers pay with a single tap using their device's saved payment method.

**Requirements:**

* Stripe must be connected as your primary gateway
* Your checkout page must be served over HTTPS
* Apple Pay requires domain verification through Stripe

<Steps>
  <Step title="Enable in Stripe">
    Log in to your Stripe dashboard, go to **Settings → Payment Methods**, and enable Apple Pay and Google Pay.
  </Step>

  <Step title="Verify domain for Apple Pay">
    In Stripe, follow the Apple Pay domain verification steps. This involves downloading a verification file and hosting it on your domain.
  </Step>

  <Step title="Test">
    Use a compatible device (Safari for Apple Pay, Chrome for Google Pay) to test the digital wallet options on your checkout page.
  </Step>
</Steps>

***

<Frame caption="Manual payment methods — add cash, check, bank transfer, or custom methods with customer-facing instructions">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/wwsLp7XUMAI9CtMc/images/payments-links-create-2.png?fit=max&auto=format&n=wwsLp7XUMAI9CtMc&q=85&s=ea368a9a063552ffd8709eaef742ec22" alt="Manual payment methods" width="1347" height="705" data-path="images/payments-links-create-2.png" />
</Frame>

***

## Manual payment methods

Manual payment methods let you accept payments outside of digital gateways — such as cash, check, bank transfer, or any custom method you define.

<Steps>
  <Step title="Open manual payment settings">
    Go to **Payments → Payment Integrations → Manual Payment Methods**.
  </Step>

  <Step title="Add a payment method">
    Click **+ Add method** and enter:

    * **Method name** — e.g., "Bank Transfer", "Check", "Cash on Delivery"
    * **Instructions** — shown to customers at checkout explaining how to pay
  </Step>

  <Step title="Save">
    Click **Save**. The manual method appears as a checkout option alongside digital payment methods.
  </Step>
</Steps>

<Note>
  When a customer selects a manual payment method, their order is placed but marked as **Payment pending** until you manually record the payment in **Payments → Transactions**.
</Note>

***

***

## Configuring payment provider by channel

You can assign different payment gateways to different channels — for example, Stripe on your website checkout and Square for in-person transactions.

<Steps>
  <Step title="Open channel settings">
    Go to **Payments → Payment Integrations → Configure by channel**.
  </Step>

  <Step title="Select a channel">
    Choose the channel (e.g., order forms, invoices, in-person, payment links).
  </Step>

  <Step title="Assign a gateway">
    Select which connected payment gateway should process payments for that channel.
  </Step>

  <Step title="Save">
    Click **Save**. Each channel now routes transactions through the designated gateway.
  </Step>
</Steps>

***

***

## Wave Accounting sync

Sync your HoopAI Platform invoices to Wave Accounting for free bookkeeping and accounting.

<Steps>
  <Step title="Connect Wave">
    Go to **Payments → Payment Integrations** and click **Connect** next to Wave Accounting.
  </Step>

  <Step title="Authorize">
    Sign in to Wave and grant access.
  </Step>

  <Step title="Configure sync">
    Choose which invoice statuses to sync (e.g., paid invoices only or all statuses).
  </Step>

  <Step title="Save">
    Invoices will sync to Wave automatically going forward.
  </Step>
</Steps>

***

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I connect multiple payment gateways at once?">
    Yes. You can connect multiple gateways and assign each to specific channels using the **Configure by channel** option.
  </Accordion>

  <Accordion title="What is the difference between Test mode and Live mode?">
    In Test mode, you can process payments using Stripe test card numbers without charging real cards. Switch to Live mode when you are ready to accept real payments.
  </Accordion>

  <Accordion title="Can I change my primary payment gateway after going live?">
    Yes. You can update your gateway connections at any time. Existing subscriptions and recurring invoices may need to be migrated manually if you switch gateways mid-cycle.
  </Accordion>

  <Accordion title="Does the HoopAI Platform take a transaction fee?">
    The platform itself does not add additional transaction fees. You pay the standard processing fees of whichever payment gateway you use.
  </Accordion>

  <Accordion title="Which gateways support subscriptions?">
    Stripe is the only gateway that supports full subscription management (create, pause, cancel, modify). NMI, Square, and Authorize.net support recurring billing through the platform's subscription retry settings but lack some advanced features like mid-cycle proration.
  </Accordion>

  <Accordion title="How do I switch from Stripe Test mode to Live mode?">
    In your Stripe dashboard, toggle from **Test mode** to **Live mode** and reconnect Stripe in **Payments → Payment Integrations**. Use live API keys in Live mode. Any subscriptions or recurring invoices created in Test mode will need to be recreated in Live mode.
  </Accordion>

  <Accordion title="Can I accept in-person payments?">
    Yes. Square supports in-person payments with Square hardware. Connect Square in **Payments → Payment Integrations** and assign it to the in-person channel under **Configure by channel**.
  </Accordion>

  <Accordion title="How do I disconnect a payment gateway?">
    Go to **Payments → Payment Integrations**, find the connected gateway, and click **Manage**. From the management screen, select **Disconnect**. Ensure no active subscriptions or recurring invoices are using that gateway before disconnecting.
  </Accordion>
</AccordionGroup>