When to use processing charges
Processing charges are appropriate when you want to:- Offset Stripe/PayPal processing fees — recover the cost of card acceptance (typically 2.9% + $0.30 per transaction) by passing it to the customer
- Add a handling or administrative fee — charge a flat or percentage fee for processing orders or invoices
- Maintain price transparency — display the fee separately so customers understand the full cost breakdown rather than building it into the product price
Setting up a global processing charge
The global processing charge configuration applies to all checkout channels you select — order forms, invoices, and payment links — across your entire account.Open payment settings
Enable the processing charge
Enter the fee name
- “Processing Fee”
- “Handling Fee”
- “Card Surcharge”
- “Administrative Fee”
Set the fee type and amount
Select the checkout channels
- Order forms — checkout pages attached to funnel steps
- Invoices — invoices sent to contacts
- Payment links — standalone payment pages
Save
How the fee appears at checkout
When a customer reaches the payment step, the processing charge appears as a separate, clearly labeled line item below the subtotal and above the total:Adding a processing charge to a specific product
In addition to the global account-level configuration, you can enable a processing charge on a specific product in the product catalog.Open the product editor
Expand additional options
Enable the processing charge for this product
Save the product
How processing charges interact with taxes
The relationship between taxes and processing charges depends on how you have configured your tax settings.Using negative line items for discounts
The same line item system that supports processing charges also supports negative-priced line items on invoices. These act as credits or discounts and reduce the invoice total. To add a credit or discount:- In the invoice editor, click + Add more products
- Select or create a product with a negative price (e.g., ”-$50.00”)
- Label it clearly: “Loyalty Discount”, “Referral Credit”, “Early Payment Discount”, or similar
Refunds and processing charges
When you issue a refund on a transaction that included a processing charge, the behavior depends on how the refund is handled:- Full refund through the HoopAI Platform: the processing charge amount is included in the refund — the customer receives back the total they paid including the fee
- Stripe’s own processing fee: Stripe does not refund the processing fee it charged you (the merchant) for the original transaction. You recover the card processing fee you paid to Stripe, but Stripe itself retains its fee. This is standard across all Stripe-connected platforms.
Compliance considerations
Processing charge compliance in the United States:- Surcharging credit cards is prohibited in some states (check current state laws as they change frequently)
- Debit card surcharging is prohibited federally under the Dodd-Frank Act
- Disclosure requirements: most jurisdictions require the surcharge to be clearly disclosed before payment is completed — the HoopAI Platform’s transparent line item display is designed to support this requirement
- Cap limits: Visa and Mastercard cap credit card surcharges at 3% of the transaction
Fee calculation examples
The table below shows how different fee configurations affect common transaction amounts:Flat rate fee of $1.50
Percentage fee of 2.9%
Processing charges on recurring invoices
If you have processing charges enabled on invoices, the fee is added to each invoice generated by a recurring template. Because each generated invoice is treated as an independent invoice, the processing fee is calculated and added fresh for each billing cycle. This means:- A monthly retainer client will see the processing fee on every invoice they receive
- Auto-payment customers will be charged the subtotal plus the processing fee each cycle
- The processing fee amount may vary slightly month to month if it is percentage-based and the invoice total changes
Disabling a processing charge
To turn off the processing charge for your account:- Go to Payments → Payment Settings → Miscellaneous Charges
- Toggle off Enable passing processing charges to customers
- Click Save
Processing charges on invoices with payment plans
If a customer has a payment plan and you have processing charges enabled on invoices, the fee applies to each installment payment independently. Each time an installment is charged, the processing fee is added to that installment amount. For example, on a $1,000 invoice with a 3% processing fee split into two $500 installments:Frequently asked questions
Can I set different processing fees for different payment methods?
Can I set different processing fees for different payment methods?
Is the processing fee refunded if I issue a refund?
Is the processing fee refunded if I issue a refund?
Can I add a processing fee to subscriptions?
Can I add a processing fee to subscriptions?
Can I customize the fee name shown to customers?
Can I customize the fee name shown to customers?
What if I only want the fee on invoices but not order forms?
What if I only want the fee on invoices but not order forms?
Can I add multiple different fees?
Can I add multiple different fees?
Does the processing fee count toward the invoice total for tax purposes?
Does the processing fee count toward the invoice total for tax purposes?
How do I verify the processing charge is appearing correctly before I go live?
How do I verify the processing charge is appearing correctly before I go live?
Can I show the processing fee as already included in the price rather than as a separate line item?
Can I show the processing fee as already included in the price rather than as a separate line item?