Set Up Aeropay Pay-by-Bank Payments at Checkout
Set up Aeropay for a facility, send payment links at the POS, capture pre-authorized online orders, and find Aeropay in reports, receipts, and refunds.
Aeropay lets customers pay by bank (ACH) at checkout. The cashier sends an Aeropay link from the POS, the customer pays from their bank, and Flourish records the payment when Aeropay confirms it. You turn it on per facility under Settings > Facilities > Payment Methods, and cashiers use it from the Aeropay tab on the POS payment screen.
Prerequisites
- An approved Aeropay merchant account.
- A Merchant Id and Merchant Location Uuid for each location. Aeropay supplies both.
- Flourish has connected Aeropay for your company. Go to Settings > Integrations > Payments and find the Aeropay card.
- If the card shows Not Connected, click Sign Up and complete the short request form. Our team contacts you to finish setup. You don't enter any credentials on this card.
- Once connected, the card shows Current status: with Active or Inactive, plus a Configure button that opens the Facilities list. The status is Active when at least one facility has Aeropay turned on.
- Permission to edit facility payment methods.
Set Up Aeropay for a Facility
Repeat these steps for each facility. Each facility has its own Merchant Id and Merchant Location Uuid.
- Go to Settings > Facilities.
- Select the facility.
- Open Payment Methods.
- Click Edit.
- Turn on the Aeropay toggle. Make sure the row heading reads Aeropay, not Aeropay - Manual.
- Enter the Merchant Id. The two fields appear only in Edit mode with Aeropay turned on.
- Enter the Merchant Location Uuid. Both fields are required.
- Optional: check Enable reconciliation against external system.
- Click Save. Flourish shows "Payment methods updated successfully!"
For the other payment methods on this screen, see Manage Facility Payment Methods.
Check Out with Aeropay
- Open the order. For in-store orders, go to Queue > In-Store > Check Out and click Checkout. For pickups and deliveries, go to Queue > Pickups or Queue > Deliveries and click View Cart. See Retail POS Complete a Purchase.
- Click Pay.
- Select the till.
- Click the Aeropay tab. The tab appears only when Aeropay is turned on for the facility. The form heading reads Aeropay Payment.
- Confirm the Customer Email and Customer Phone. Both are required and pre-filled from the customer's profile.
- Enter the Aeropay Payment Amount, or click the balance under Remaining to fill in the full amount. Clear appears once you enter an amount.
- Click Send Aeropay Link. The button stays disabled until the email, phone, and an amount above $0 are entered.
Aeropay, not Flourish, sends the customer the payment link.
What the customer does
The customer opens the link and approves the payment with Aeropay.
While you wait
The POS shows "Transaction in progress..." You can't start another payment on the order until it resolves. Aeropay notifies Flourish, and the POS updates on its own.
- Approved, covers the balance: Flourish records the payment and completes the order as with any other payment.
- Approved, covers part of the balance: the POS shows "Partial payment received. Please complete payment." and returns to the payment screen so you can collect the rest.
- Declined or failed: the POS shows "Transaction was unsuccessful" with Aeropay's reason. The message stays until you dismiss it.
- Customer never completes the link: A pending Aeropay link has no cancel or resend option and will expire.
Capture a Pre-Authorized Online Order
Orders from an online ordering partner that pre-authorizes payment with Aeropay arrive with a pre-authorized payment. The customer's funds are on hold until you capture the payment.
On the payment screen, a banner reads "Pre-authorized payment of {amount} is ready to capture" when the order is ready. If the order isn't ready, the screen shows "Pre-authorized payment cannot be captured yet" and "The order must be fully allocated and packed before the pre-authorized payment can be captured." Click Back to Cart. Capture requires the order to be Packed (or later) and fully allocated.
- Open the order and click Pay.
- Click Capture Pre-Authorized Payment in the banner.
- Review Method, Authorized Amount, Reference ID, and Order Total. When available, the modal also shows Tip (included in auth), Transaction Fee, and Auth Expires.
- Choose the till in Select Till if no till is selected.
- Click Capture Payment. The button shows "Capturing..." while it works.
Flourish automatically adjusts the authorized amount to match the order total before capturing.
Void an Authorization
- In the capture modal, click Void this authorization instead.
- Confirm the prompt: "Are you sure you want to void this pre-authorized payment? This will release the hold on the customer's funds and the order will revert to Awaiting Payment."
Flourish shows "Authorization voided successfully."
If the Authorization Expires
Auth Expires shows when Aeropay's hold ends. A nightly process marks expired holds, and the order shows Pre-Auth Expired. Collect payment another way.
Refund an Aeropay Purchase
The POS offers a payment method for a refund only if it's enabled for returns at the facility. Integrated Aeropay has no Allow as refund method for returns option, so Aeropay isn't offered as a refund method. Refund the purchase with another enabled method, such as cash or customer account credit. See Retail POS Refund a Purchase. [VERIFY: product to confirm whether refunds back to integrated Aeropay should be supported]
For Aeropay - Manual payments, see Retail POS - Refund an Aeropay Transaction.
Aeropay in Reports and Receipts
Where | What you see |
Till Report | Total Aeropay includes both Aeropay and Aeropay - Manual. |
Transactions by Facility | Separate Aeropay and Aeropay Manual columns, each shown only when that type is active. |
Close-till summary | An Aeropay line. |
Printed receipt | "Aeropay Paid:" for integrated, "Aeropay - Manual Paid:" for manual. |
E-Payments reconciliation | Aeropay and Aeropay - Manual are listed separately. [VERIFY: integrated Aeropay appears in E-Payments reconciliation when the reconciliation checkbox is on] |
See Track Dispensary Sales with Till Report and Reconciling E-Payments.
Troubleshooting
If you see | Do this |
"Aeropay is missing Merchant Id, Merchant Location Uuid" (lists whichever fields are blank) | Enter the blank fields, then click Save. Save is blocked until you do. See Set Up Aeropay for a Facility. |
"integration with Aeropay has not been configured for your company. Please contact Flourish for assistance in setting it up" | Flourish hasn't connected Aeropay for your company. Click Sign Up on the Aeropay card in Settings > Integrations > Payments and complete the request form. Our team contacts you to finish setup. |
No Aeropay tab on the payment screen | Turn on Aeropay for the facility in Payment Methods. |
Send Aeropay Link is disabled | Enter the customer email, phone, and an amount above $0. |
"Please enter valid payment amount" | Enter an amount above $0, up to the remaining balance. |
"Please enter customer email" | Enter the customer's email. |
"Please enter valid customer email" | Correct the email address. |
"Please enter customer phone number" | Enter the customer's phone number. |
"Please select till before submitting payment" | Select the till, then send the link again. |
"Awaiting resolution of previous payment transaction. Please wait until it completes." | Wait for the pending Aeropay payment to resolve. You can't start another payment on the order until then. |
"Partial payment received. Please complete payment." | Collect the rest on the payment screen. |
"Transaction was unsuccessful" | Read Aeropay's reason and dismiss the message. [VERIFY: whether you can send a new Aeropay link after a declined payment] |
"Pre-authorized payment cannot be captured yet" | Click Back to Cart, fully allocate the order, and pack it. Then capture. |
"Please select a till before capturing." | Choose a till in Select Till, then click Capture Payment. |
"This authorization is no longer open (it may have been captured or voided elsewhere). The payment screen shows the current state." | Check the payment screen for the current state. Someone may have already captured or voided it. |
Capture Failed / "Failed to capture payment. Please try again." | Click Capture Payment again. |
Void Failed | Click Void this authorization instead again. [VERIFY: what to do if voiding keeps failing] |
Pre-Auth Expired on the order | The hold ended. Collect payment another way. |
"There are no valid payment methods available to refund this purchase. Please contact an administrator for assistance." | Ask an administrator to enable a refund method for the facility. See Manage Facility Payment Methods. |
How did we do?
Aeropay Manual for Retail Point of Sale