Add-on: Fortis payments

The Fortis Add-on enables you to accept credit card and ACH (bank account) payments directly through your customer portal and management dashboard. Your customers can save their payment methods for automatic billing. All transactions sync seamlessly between Storeganise and your Fortis account.

Prerequisites

Before installing the Fortis Add-on, ensure you have:
  • An active Fortis merchant account
  • Access to your Fortis Dashboard credentials
  • Your Fortis User ID and Location ID (found in your Fortis Dashboard)
  • Admin access to your Storeganise account
  • The Add-on is installed at the individual site level

Setting up the Fortis Add-on

The Add-on automatically creates a custom field called Fortis Transaction Id on your invoices. This field tracks payment transactions and prevents duplicate charges.
Step 1: Connect your Fortis account
After installation, you need to connect your Fortis account using OAuth:
  1. Go to Settings → Add-ons → Fortis
  2. Click Connect to Fortis
  3. You'll be redirected to the Fortis authorization page
  4. Log in with your Fortis Dashboard credentials
  5. Grant Storeganise access to your Fortis account
  6. You'll be redirected back to Storeganise
Once connected, the Add-on securely stores your authorization token.

After successful authorization, you'll need to add information from your Fortis Merchant Gateway:Location ID
  • Find in: Locations > Site location > General info > Location Id
  • Need help? Follow Fortis's guide to find your Location ID
  • Enter in Add-on settings
  • Important: Your Location ID determines the currency for all transactions. International cards are accepted but will be charged and settled in the currency configured for your Fortis merchant location/account.

Product Transaction IDsContact your Fortis account manager if you need additional payment methods enabled

How payment methods work

Credit card payments
When customers add a credit card through your customer portal:
  • The card information is securely tokenized by Fortis
  • Only the last 4 digits are stored and displayed in Storeganise
  • Credit card payments are processed immediately
  • Invoice status updates to "paid" right away
  • The payment appears in your Fortis Dashboard within minutes
ACH (bank account) payments
When customers add a bank account:
  • Bank account details are securely tokenized by Fortis
  • Only the last 4 digits of the account number are displayed
  • ACH payments enter a "pending" state for 2-3 business days
  • Invoice status remains "pending" during clearing
  • Once cleared, the invoice automatically updates to "paid"
  • The payment appears in your Fortis Dashboard during the clearing period
Note: ACH payments take longer to process due to standard banking clearing times. This is normal and expected behavior.
Payment method display
Payment methods are displayed differently depending on where you're viewing them:Customer portal (Billing section): - Credit cards show: Card brand  + last 4 digits (e.g., "VISA •••• 4242") - Bank accounts show: Bank icon + last 4 digits (e.g., " •••• 0021")Management Portal (Customer billing section): - Shows the same masked format - Displays which payment method is set as default - Allows you to view all saved methods for each customer
Updating payment methods
Customers can update their payment methods at any time:
  1. Go to the customer portal
  2. Navigate to Billing
  3. Click Update payment methods
  4. Add a new payment method or select a different existing method
  5. The new method is automatically saved and can be set as default
When a customer updates their payment method, the new method is used for all future charges.

Processing payments

Automatic payment processing
When automatic billing is enabled, invoices are charged automatically:For credit cards: 1. Invoice is generated 2. Payment is processed immediately 3. Invoice status updates to "paid" 4. Customer receives payment confirmationFor ACH payments: 1. Invoice is generated 2. ACH transaction is initiated 3. Invoice status shows "pending" 4. After 2-3 business days, invoice updates to "paid" 5. Customer receives confirmation once cleared

Manual payment processing
You can manually charge invoices in two ways:From the customer portal (customers can do this): 1. Navigate to Invoices 2. Find the unpaid invoice 3. Click Pay Invoice 4. Select the saved payment method 5. Confirm paymentFrom the Management Portal (admins can do this): 1. Go to the customer's invoice 2. Click Charge Invoice 3. The system uses the customer's saved payment method 4. Payment processes immediately (credit card) or enters pending state (ACH)
Understanding transaction IDs
Each successful payment creates a unique Fortis Transaction Id that's stored on the invoice. This transaction ID:
  • Links the Storeganise invoice to the Fortis payment record
  • Prevents duplicate charges on the same invoice
  • Persists across sites (in multi-site setups, each site has its own transaction IDs)
  • Allows you to track payments in both systems
Important: If a payment fails, you can retry the charge. The system will create a new transaction ID for each attempt.
Refunds
Refunds are not yet available directly through Storeganise with the Fortis Add-on. To process a refund:
  1. Process the refund in your Fortis Dashboard
  2. Record the refund in Storeganise using the Manual payment option for credit notes
This ensures your records stay synchronized between both systems while the refund processes through Fortis.Note: Direct refund processing through Storeganise will be available in version 2 of the Add-on.

Currency support

The Fortis Add-on automatically detects the currency of each invoice:
  • Supported currencies: USD (US Dollars) and CAD (Canadian Dollars)
  • Currency is determined by the invoice settings in Storeganise
  • Each payment is processed in the invoice's currency
  • Currency information is sent to Fortis with each transaction
If you use a currency that's not supported by Fortis, the payment will fail with a clear error message.

Multi-site configuration

Business-level installation (shared merchant account)
If you install the Add-on at the business level:
  • One Fortis merchant account is used across all sites
  • All sites share the same OAuth connection
  • Payment methods are still isolated per site
  • Customers can only see payment methods for their specific site
  • Reporting in Fortis shows all transactions across sites
This approach works well if you want centralized payment management and consolidated reporting.
Site-level installation (independent accounts)
If you install the Add-on at the site level:
  • Each site connects to its own Fortis merchant account
  • Sites have completely independent OAuth connections
  • Payment methods are fully isolated between sites
  • Each site can have different Fortis configurations
  • Reporting in Fortis is separated by site
This approach is ideal if you operate sites in different regions or want complete separation between locations.
Site isolation behavior
Regardless of installation type, payment methods are always isolated:
  • A customer on Site A cannot see or use payment methods from Site B
  • Transaction IDs are site-specific and don't cross-contaminate
  • Each site's invoices operate independently
  • Customers with accounts on multiple sites must add payment methods separately for each site

Troubleshooting

Connection issues
Problem: OAuth connection fails or redirects to an error pageThe OAuth connection requires valid Fortis Dashboard credentials and proper authorization.Solution: 1. Verify you're using the correct Fortis Dashboard login credentials 2. Check that your Fortis account has active status 3. Ensure your browser allows redirects from Storeganise 4. Try disconnecting and reconnecting the Add-on 5. Clear your browser cache and try againIf the issue persists, contact Fortis support to verify your account has API access enabled.
Problem: "Payment setup failed" error when adding payment methodThis error typically occurs if there's a communication issue between Storeganise and Fortis.Solution: 1. Check that the OAuth connection is still active in Settings → Add-ons → Fortis 2. Verify your Fortis account hasn't expired or been suspended 3. Try reconnecting the OAuth connection 4. Contact support if the error message includes specific technical details
Payment processing issues
Problem: Credit card payment fails with "card declined" errorCard declines can happen for various reasons including insufficient funds, incorrect card details, or security blocks.Solution: 1. Ask the customer to verify their card details are correct 2. Ensure the card hasn't expired 3. Check if the customer's bank is blocking the transaction 4. Try a different payment method 5. Contact Fortis support if legitimate cards are consistently declined
Problem: ACH payment stays in "pending" status for more than 5 business daysACH payments normally clear within 2-3 business days, but delays can occur.Solution: 1. Check the transaction status in your Fortis Dashboard 2. Verify the payment was successfully initiated 3. Confirm the bank account details were correct 4. Look for any failure notifications in Fortis 5. Contact Fortis support to investigate the specific transactionIf the ACH payment failed, you can retry the charge manually.
Problem: Invoice shows "paid" but payment isn't in Fortis DashboardOccasionally, there may be a sync delay between systems.Solution: 1. Check the Fortis Transaction Id custom field on the invoice 2. Search for that transaction ID in your Fortis Dashboard 3. Verify the payment was actually processed 4. Wait 15-30 minutes for sync delays to resolve 5. If the transaction ID exists but isn't in Fortis, contact support
Problem: Customer sees error "No payment method added" when trying to payThis occurs when a customer hasn't saved a payment method or the saved method was removed.Solution: 1. Ask the customer to go to Billing in the customer portal 2. Click Update payment methods 3. Add a new credit card or bank account 4. Return to the invoice and try paying again
Problem: Duplicate charges on the same invoiceThe Fortis Transaction ID system prevents duplicate charges, but issues can occur if the transaction ID isn't properly saved.Solution: 1. Check if the invoice has a Fortis Transaction Id in the custom field 2. If multiple transaction IDs exist, check your Fortis Dashboard to see which processed successfully 3. If a customer was genuinely charged twice, process a refund through Fortis Dashboard 4. Contact support if duplicate charges occur regularlyThe system is designed to prevent this, so recurring duplicates indicate a configuration issue.
Problem: Payment method shows in customer portal but won't process paymentsPayment methods must be properly tokenized by Fortis to work correctly.Solution: 1. Ask the customer to remove the payment method 2. Re-add the payment method through the booking flow or billing page 3. Verify the new method appears with the correct last 4 digits 4. Try processing a test paymentIf the issue continues, the payment method may have failed tokenization. Contact Fortis support to investigate.
Multi-site specific issues
Problem: Customer payment methods appearing on wrong siteThis shouldn't happen, but can occur if sites are misconfigured.Solution: 1. Verify each site has its own OAuth connection (for site-level installations) 2. Check that the Fortis Transaction Id custom field is configured at the site level 3. Confirm the customer account is properly associated with the correct site 4. Contact support if cross-site contamination persists
Problem: Shared merchant account showing wrong site attributionWhen using business-level installation, all transactions go through one Fortis account.Solution: 1. Use transaction metadata in your Fortis Dashboard to identify the originating site 2. Each transaction includes site information in the payment description 3. Filter your Fortis reports by site-specific identifiers 4. Consider switching to site-level installation if you need complete separation

Frequently asked questions

1. What is the Fortis Add-on and who can use it?

The Fortis Add-on is a payment processing integration that enables self-storage operators using Storeganise to accept credit card and ACH (bank account) payments directly through their customer portal and management dashboard. This integration connects your Storeganise account with Fortis, a leading payment gateway, allowing customers to save payment methods for automatic billing and enabling operators to process manual payments when needed. The Add-on is available to all Storeganise customers who have an active Fortis merchant account with approved underwriting.

2. How do credit card and ACH payments differ in processing time?

Credit card and ACH payments process differently due to their underlying payment networks. Credit card payments are processed immediately—when a customer pays with a credit card, the invoice status updates to "paid" right away, and the transaction appears in your Fortis Dashboard within minutes. ACH (bank account) payments, however, enter a "pending" state for 2-3 business days while the payment clears through the banking system. During this time, the invoice status remains "pending," and once the ACH payment successfully clears, the invoice automatically updates to "paid." This delay is normal and reflects standard banking clearing times.

3. What's the difference between business-level and site-level installation?

The Fortis Add-on offers two installation approaches to suit different business structures. Business-level installation uses one Fortis merchant account across all sites, with all sites sharing the same OAuth connection and transactions consolidated in a single Fortis account—ideal for centralized payment management. Site-level installation allows each site to connect to its own independent Fortis merchant account with completely separate OAuth connections and isolated reporting—perfect for operators managing sites in different regions or requiring complete separation between locations. Regardless of installation type, payment methods are always isolated per site, ensuring customers can only see and use payment methods associated with their specific site.

4. How does the Fortis Transaction ID prevent duplicate charges?

Each successful payment through the Fortis Add-on creates a unique Fortis Transaction ID that's automatically stored in a custom field on the invoice. This transaction ID links the Storeganise invoice to the Fortis payment record and serves as a critical safeguard against duplicate charges. When the system attempts to charge an invoice, it first checks if a transaction ID already exists—if one is present, the system prevents the duplicate charge from processing. The transaction ID persists across sessions and is site-specific in multi-site setups. If a payment fails, you can retry the charge, and the system will create a new transaction ID for each attempt, allowing legitimate retries while still protecting against accidental duplicates.

5. Can customers use multiple payment methods, and how is the default method determined?

Yes, customers can save multiple credit cards and bank accounts in the system. When multiple payment methods are saved, customers can select which method to use when paying invoices manually through the customer portal. For automatic billing, the system uses the most recently added or updated payment method as the default. Customers can change their default payment method at any time by going to the Billing section in the customer portal, clicking "Update payment methods," and adding or selecting their preferred method. The newly selected method will automatically become the default for future automatic charges.

6. What happens when a payment fails, and how can I retry it?

When a payment fails, the invoice remains in "unpaid" or "failed" status, and the customer receives a notification if configured. Failed payments don't block future payment attempts—you have multiple options for retrying. From the Management Portal, navigate to the customer's invoice and click "Charge Invoice" to retry using the customer's saved payment method. Customers can also retry from their customer portal by going to Invoices, finding the unpaid invoice, and clicking "Pay Invoice." Each retry attempt creates a new transaction ID, allowing the system to track multiple attempts while still preventing duplicate successful charges. Common failure reasons include insufficient funds, expired cards, incorrect bank details, or security blocks from the customer's financial institution.

7. How does currency detection work, and what currencies are supported?

The Fortis Add-on automatically detects the currency of each invoice based on your Storeganise invoice settings. Currently, the Add-on supports USD (US Dollars) and CAD (Canadian Dollars). When you create an invoice in Storeganise, the currency information is automatically sent to Fortis with each payment transaction, ensuring the payment is processed in the correct currency. If you attempt to process a payment in a currency that Fortis doesn't support, the payment will fail with a clear error message. This automatic detection eliminates the need for manual currency configuration and reduces the risk of processing payments in the wrong currency.

8. Are payment methods secure, and what information is stored in Storeganise?

Payment security is handled by Fortis using industry-standard tokenization protocols. When customers add a payment method, the sensitive card numbers and bank account details never touch Storeganise servers—instead, Fortis securely tokenizes the information and returns only a token and the last 4 digits to Storeganise. All payment data is encrypted both in transit and at rest. Fortis is PCI DSS compliant for card payments, meeting the highest security standards. Staff members viewing payment information in Storeganise can only see the payment method type (credit card or ACH), the last 4 digits, and transaction IDs linking to Fortis records. Full payment details are only accessible in your Fortis Dashboard, which has its own separate access controls and security measures.

9. What should I do if the OAuth connection fails during setup?

OAuth connection failures typically occur due to credential issues or authorization problems. First, verify you're using the correct Fortis Dashboard login credentials and that your Fortis account has active status. Ensure your browser allows redirects from Storeganise, as the OAuth flow requires redirecting to Fortis and back. Try disconnecting and reconnecting the Add-on by going to Settings → Add-ons → Fortis. If the problem persists, clear your browser cache and cookies, then attempt the connection again. You should also verify with Fortis support that your account has API access enabled—some merchant accounts may require this to be specifically activated. If you continue experiencing issues after these steps, contact Storeganise support with any specific error messages displayed during the connection attempt.

10. Can I process refunds through the Fortis Add-on?

No, refunds cannot be processed directly through the Fortis Add-on in Storeganise. All refunds must be initiated and processed through your Fortis Dashboard, where you have full control over refund amounts and processing. After you issue a refund in Fortis, you'll need to manually update the invoice status in Storeganise to reflect the refund, or create a credit note to adjust the customer's account balance. This separation ensures proper financial controls and maintains accurate records in both systems. The refund transaction will appear in your Fortis Dashboard with all relevant details, and you can reference the Fortis Transaction ID from the Storeganise invoice to locate the corresponding payment record in Fortis.

11. How are payment methods isolated in multi-site configurations?

Payment method isolation is a core security and organizational feature of the Fortis Add-on, working identically regardless of whether you use business-level or site-level installation. When a customer adds a payment method on Site A, that payment method is exclusively available for Site A transactions—it cannot be seen or used for Site B, even if the same customer has an account there. Transaction IDs are also site-specific and never cross-contaminate between sites. If a customer rents units at multiple sites within your business, they must add payment methods separately for each site, and each site's invoices are processed completely independently. This isolation ensures proper accounting, prevents accidental cross-site charges, and maintains clear financial boundaries between different locations in your reporting.

12. What's the difference between immediate and delayed charging?

Immediate charging and delayed charging offer different timing options for when customer payments are processed. With immediate charging, the invoice is charged as soon as it's generated—this works best for move-ins, new rentals, or one-time charges where you want instant payment. The customer must already have a saved payment method for immediate charging to work. Delayed charging creates the invoice but doesn't charge it immediately; instead, the charge occurs on a specific future date that you designate. This is particularly useful for monthly recurring charges where invoices are generated at the beginning of the billing period but should be charged on a specific date, or when you want to give customers advance notice of upcoming charges. Both methods work with credit cards and ACH payments, though ACH payments will still require 2-3 business days to clear regardless of when charging is initiated.

Need more help? Contact Storeganise support or reach out to your Fortis account representative for payment gateway specific questions.
Add-on: Fortis payments