Skip to main content

How to Pre-authorize a Payment

Learn how to pre-authorize, capture, and void a credit card hold on an opportunity in SmartMoving. Voiding cancels an active pre-authorization and releases the hold while keeping a Voided record.

Written by Michelle Carone

Overview

Pre-authorizing a payment places a temporary hold on a customer's credit card to confirm they have enough funds to cover the job. The hold reserves the amount without charging it. After the job is complete, you can capture the payment to finalize the charge. If a job does not go ahead, you can void the pre-authorization to cancel the hold and release the reserved funds back to the customer.


Before You Start


How to Pre-authorize a Payment

Step 1: Save a Card on File (If Needed)

If the customer does not already have a card on file, save one first.

  1. Open the opportunity and go to the Payments section.

  2. Click Payment, then select Take Payment.

  3. In Payment Category select On File to store the card without any charges applied.

  4. Click Store Card. The saved card appears in the Payments section.


Step 2: Run the Pre-authorization

  1. In the Payments section of the opportunity, click Payment.

  2. Select Pre-authorize Payment from the dropdown menu. The Pre-authorize Payment dialog opens.

  3. Choose a payment method:

    • Saved Payment Methods: Select an existing card on file.

    • Credit Card: Enter new card details for this pre-authorization.

  4. Review the hold amount. A confirmation message displays the amount that will be held and the card it will be placed on.

  5. Click Pre-authorize. The hold is placed on the card.

The payment entry appears in the Payments section with a Pre-authorized badge, along with the date, card details, and the amount held.


How to Capture a Pre-authorized Payment

After the job is complete, capture the pre-authorized payment to finalize the charge.

  1. In the Payments section of the opportunity, find the payment entry with the Pre-authorized badge.

  2. Click the three-dot menu (⋮) on the pre-authorized payment.

  3. Select Capture Payment. The Capture Payment dialog opens.

  4. Enter the Amount to capture. The capture amount can match the pre-authorized amount or be higher if the final invoice came in above the estimate.


  5. Click Capture. A confirmation message indicates the payment is complete.

The payment status updates from Pre-authorized to show the captured amount as paid.

Note: If the capture amount is higher than the pre-authorized amount, SmartMoving first charges the pre-authorized hold, then charges the difference to the same card. If the card does not have enough funds for the difference, the remainder will decline and you will need to collect the balance from the customer using another form of payment.


How to Void a Pre-authorized Payment

Voiding a pre-authorization cancels the hold on the customer's credit card before the payment is captured. SmartMoving cancels the pre-authorization with the card processor before the charge settles, and the hold is released back to the customer's available balance. No money moves and the customer is never charged.

You can void a pre-authorization only while the hold is active: the payment entry shows a Pre-authorized badge and has not been captured, has not expired, and has not already been voided.

  1. In the Payments section of the opportunity, find the payment entry with the Pre-authorized badge.

  2. Click the three-dot menu (⋮) on the pre-authorized payment.

  3. Select Void Pre-Authorization. A confirmation dialog opens.

  4. Review the confirmation message: "This will cancel the pre-authorization with the card processor and release the hold on the customer's card. This action cannot be undone."

  5. Click Void. SmartMoving cancels the pre-authorization with the card processor and releases the hold on the customer's card.

After you void the pre-authorization, the payment entry stays in the Payments section with a Voided badge, so you keep a record of it.

Capture Payment and Void Pre-Authorization are no longer available on that entry, and Delete remains available if you want to remove the entry from the screen. SmartMoving records an activity entry on the opportunity, for example: "Pre-authorization of $500.00 voided by Jordan Lee."

Note: Voiding a pre-authorization cannot be undone. To place another hold after voiding, run a new pre-authorization on the opportunity.

When Void Pre-Authorization is not available: Void is only available while the pre-authorization is active.

  • If the payment entry shows a Captured status, the payment was already finalized, so process a refund instead.

  • If the entry shows Expired, the hold was already released after the 5-day capture window passed, so no void is needed.

  • If the entry shows Voided, the pre-authorization was already voided and cannot be voided again.


Void vs. Delete on a Pre-authorization

The three-dot menu on a pre-authorized payment includes both Void Pre-Authorization and Delete. The table below shows what each action does and whether a record is kept.

Action

What it does

Record kept

Void Pre-Authorization

Cancels the pre-authorization with the card processor and releases the hold on the customer's card. No funds move.

Yes. The entry stays visible with a Voided badge.

Delete

Removes the pre-authorization entry from the opportunity's Payments section.

No. The entry is removed from the screen.

Use Void Pre-Authorization when you want to cancel the hold and keep a record of it for accounting. Use Delete when you want to remove the entry from the Payments section.


How to Capture a Pre-authorized Payment in the Crew App

When a customer has a pre-authorized card on file, the Crew App highlights that card on the Take Payment screen so crews can capture the held amount directly.

The pre-authorized card displays a PRE-AUTH tag next to the card label, along with the held amount and the date the hold was placed. The card is pre-selected by default when the crew opens the Take Payment screen.

How to Capture

  1. Open the job in the Crew App and tap Take Payment.

  2. Confirm the pre-authorized card is selected. The card displays a PRE-AUTH tag, the held amount, and when the hold was placed.

  3. Tap Capture Payment to finalize the charge against the existing hold.


Choosing a Different Payment Method

Other saved cards remain available below the pre-authorized card. To use a different payment method, select it from the list. The button label changes to Add New Payment, and the charge is processed as a standard payment, not a capture of the existing hold.

💡 SmartTip: Selecting the pre-authorized card and tapping Capture Payment applies the charge to the existing hold. Selecting a different card processes a separate charge and does not release the pre-authorized hold automatically.

Note: When pre-authorization is activated on an opportunity, whichever card was most recently saved on file for that opportunity is used for the pre-authorization.


Best Practices

  • Pre-authorize the customer's card before the job date to confirm they have sufficient funds and reduce the risk of payment issues on moving day.

  • Have your crew finalize the job in the crew app as soon as the move is complete. After 5 days, you will no longer be able to capture payment from the pre-authorization.

  • Capture the pre-authorized payment as soon as the job is finalized to avoid missing the 5-day window.

  • Know the typical variance between your estimates and final invoices, and set pre-authorization amounts accordingly. If the capture amount exceeds the hold, the difference is charged to the same card and can decline if funds are short.

  • Select the pre-authorized card on the Crew App Take Payment screen to capture the existing hold. Selecting a different card processes a separate charge without releasing the hold.


Troubleshooting

The Pre-authorize Payment option does not appear.

Pre-authorization may not be enabled for your account. Book a call with Theo at Remedy Payments to get set up.

The pre-authorization failed.

Verify that the card details are correct and that the card has sufficient available credit for the hold amount. If the issue persists, try entering the card details manually instead of using a saved card.

The capture declined for the amount above the pre-authorized hold.

When the capture amount is higher than the pre-authorization, SmartMoving charges the hold first and then charges the difference to the same card. If the card lacks funds for the difference, that portion declines. Collect the remaining balance from the customer using another form of payment.

The pre-authorized payment shows as Expired.

The hold on the card expired before it was captured. You will need to run a new pre-authorization or take a standard payment instead.

The Void Pre-Authorization option is unavailable or grayed out.

Void Pre-Authorization is only available while a pre-authorization is active. Check the badge on the payment entry. If it shows Captured, the payment was already finalized, so process a refund instead. If it shows Expired, the hold was already released. If it shows Voided, the pre-authorization was already voided.

Voiding the pre-authorization failed.

The hold may have already been captured or expired, or the card processor returned an error. Refresh the Payments section to check the current badge on the entry. When a void fails, no changes are saved and the entry stays in its previous state. Try again, or process a refund if the payment has already been captured.

Did this answer your question?