Payment Holds allow users to temporarily prevent an unpaid order from being picked and shipped until the order has been paid in full, which excludes the order from the picking queue until the hold is removed.
- Managing Payment Holds
- Store Integrations - Map Statuses
- Payment Holds from Shopify
- Notification Settings
Managing Payment Holds
There are multiple ways to update a payment hold on an order. For specific instructions, please visit our article, Managing Order Holds in ShipHero.
- Dashboard: Manually apply or remove holds directly through the ShipHero user interface.
- Automation Rules: Set up rules to automatically apply a hold using the Set Payment Hold action, which is triggered by specific order conditions.
- Store Integration: Certain e-commerce platforms, like BigCommerce, can automatically set a payment hold when orders are imported using the Map Statuses setting on the store connection in ShipHero. More information below.
- API: Use GraphQL mutations to programmatically control payment holds. Visit our Developer Site for more information on using the API.
Store Integrations - Map Statuses
For supported stores, an order can automatically be assigned a payment hold based on its status in the e-commerce platform. For unsupported stores, holds must be managed manually.
How to Map Statuses
- Go to My Account Stores and click the Map Statuses on the store.
- Select Payment Hold from the appropriate drop-down from the Order Hold column.
- Click Save.
The table below provides a quick reference for e-commerce platforms and their support for automatic payment holds.
| Supported Stores (Automatic Mapping) | Unsupported Stores (Manual Management) |
|---|---|
| BigCommerce | Shopify* |
| WooCommerce | Amazon |
| Magento v2 | eBay |
| Mystoreno | Walmart |
| Etsy | |
*Note: While Shopify is not a supported store for the Map Statuses feature, it has its own dedicated Payment Hold settings explained in the next section.
Payment Holds from Shopify
By default, unpaid orders from Shopify will import into ShipHero with a payment hold. There are several settings available to further manage your payment holds between Shopify and ShipHero.
How to Update the Shopify Payment Hold Settings
- Go to the My Account > Stores page and click the Settings button.
- Scroll down to the Sync Settings Shopify to ShipHero section.
- Enable/Disable the desired setting.
- Click Save.
Available Sync Settings Shopify to ShipHero | |
| Store Setting | Behavior when Enabled |
| Even if order is unpaid in Shopify, never apply a Payment Hold | Disables the default behavior of applying a Payment Hold to an unpaid Shopify order when imported. |
| If an order is paid in Shopify, but has a payment hold in ShipHero, remove the payment hold in ShipHero. | Removes a payment hold once the order has been paid in Shopify. |
| Only import orders into ShipHero that have been paid for. | This does not apply a payment hold to an order, instead it prevents unpaid orders from importing into ShipHero from Shopify. |
Notifications Settings
To receive email notifications when an order imports with a payment hold, add the contact email to the Notify Payment Hold field on the My Account Settings page. More information about other notification settings can be found here.
- Go to the My Account Settings page.
- Type the person or teams' email and press Enter in the "Notify Payment Hold Email" field. The email will be highlighted with a green box to indicate the info is properly added.
- Click Save Changes.
Note: Payment hold notifications are only sent when an order is first placed on hold during the import process.