Show payment widget and discounts for preorder products

STOQ allows you to display payment options and discount information directly on your product pages, cart, and checkout for preorder products. This payment widget helps customers understand their purchasing options and potential savings at every step of the buying journey, increasing transparency and encouraging preorder commitments.

Enabling the Payment Widget

The payment widget displays your configured payment options (full payment, partial payment, or both) along with any discounts you offer. Before enabling the widget, you need to have a preorder offer set up with your desired payment configuration.

Accessing Payment Settings

1. From your Shopify admin, open the STOQ app.
2. Click Preorders in the left navigation menu.
3. Select Edit Offer for the preorder offer you want to update.
4. Click on the Payment tab within your offer settings.

Configuring Payment Type

Choose the payment option you want to offer customers under Payment type:

• Full payment: Customers pay the entire product price at checkout.
• Partial payment or deposit: Customers pay a portion upfront and the remaining balance later.
• Full payment & partial payment: Offer both options and let customers choose their preferred payment method.

Setting Up Partial Payments

If you select partial payment as your payment option, you can configure the deposit amount and remaining payment schedule.

Deposit Amount Configuration

You can set the deposit as either a percentage of the total price or a fixed amount:

• Click the Percentage icon to collect a percentage of the product price at checkout.
• Click the Amount icon to collect a specific dollar amount at checkout.
• Enter the value in the field provided.

Remaining Payment Schedule

Configure when the remaining balance will be due:

• On a specific date: Click the calendar icon and select the date when the remaining payment should be collected.
• Days after checkout: Click the clock icon and enter the number of days after checkout when the remaining payment will be due.

Collecting Remaining Payments

For partial payment offers, you can choose how to collect the remaining balance:

• Manual collection: Collect remaining payments manually from Shopify admin or STOQ Reports when you're ready.
• Automatic collection (paid plans only): Payments are automatically collected either on the scheduled date or when the order ships.

Configuring Discounts

Offering discounts on preorder products can incentivize customers to commit early. STOQ allows you to configure discounts that display in the payment widget.

Setting Up a Discount

1. In the Payment tab, locate the Discount on total price section.
2. Select your discount type:

• Percent: Apply a percentage discount off the total price.
• Amount: Apply a fixed dollar amount discount.
• None: No discount applied.

3. Enter the discount value in the field provided.

Customizing the Discount Badge

When a discount is configured, you can customize how it appears in the payment widget:

1. Click Customize next to the discount section.
2. Enter your preferred badge text in the Badge field.
3. Use the {{ discount }} variable to dynamically display the discount amount or percentage.

Example badge text: "Save {{discount}}" will display as "Save 10%" or "Save $15" depending on your configuration.

Display Settings

Control how payment and discount information appears to customers throughout their shopping experience.

Enabling the Payment Widget Display

For single payment options (full or partial payment only):

1. In the Payment tab, scroll to the Display section.
2. Check the box for Show payment & discount savings.
3. Click Save at the bottom of the page.

This setting displays the payment widget on the product page, showing customers their payment options and any applicable discounts.

Show Discounted Price

When you have a discount configured, you can also enable the discounted price display:

1. In the Display section, check Show discounted price.
2. This displays the final discounted price next to the original price on the product page.

Full and Partial Payment Display Options

When offering both full and partial payment options:

• The payment widget automatically displays both options for customers to choose from.
• Check Show partial payment option first if you want the partial payment option to be selected by default.

Where the Payment Widget Appears

Once enabled, the payment widget displays payment and discount information at multiple touchpoints in the customer journey.

Product Page

The payment widget appears below the product price, showing:

• Available payment options (full payment, partial payment, or both)
• Payment titles and descriptions you configured
• Discount badges when applicable
• The discounted price (if enabled)

Cart Page

In the cart, customers see:

• The preorder product highlighted with payment information
• Line item properties showing payment details
• Shipping timeline information (if configured)

Checkout Page

At checkout, customers see:

• Their selected payment option
• The amount due now and any remaining balance
• The payment due date for partial payments

Customizing Payment Option Labels

You can customize the titles and descriptions shown in the payment widget to match your brand voice.

For Single Payment Options

1. In the Payment tab, click Customize next to your payment type.
2. Edit the Title field (e.g., "Full payment" or "Reserve now, pay later").
3. Edit the Description field to explain the payment terms.
4. Click Save to apply your changes.

For Full and Partial Payment Options

When offering both options, you can customize each separately:

1. Click Customize under the Full payment section to edit full payment labels.
2. Click Customize under the Partial payment section to edit partial payment labels.
3. Use the {{ payment }} variable in descriptions to show the deposit amount.
4. Use the {{ remaining }} variable to show the remaining balance.

Example description: "Pay {{payment}} upfront and the remaining will be charged when your product is shipped."

Known Limitations

The payment widget feature has some platform constraints to be aware of.

• Partial payments require Shopify Payments as your payment provider.
• Credit card authorizations typically expire after 7-30 days, which may affect partial payment collection timing.
• The payment widget only appears for products linked to an active preorder offer.
• Automatic payment collection is only available on paid STOQ plans.

Troubleshooting

If you encounter issues with the payment widget display, use this guide to identify and resolve common problems.

FAQs

Q: Can I offer different discounts for full payment vs partial payment?

A: Yes, when you select "Full payment & partial payment" as your payment type, you can configure separate discounts for each option. This allows you to incentivize full upfront payments with a larger discount while still offering a partial payment option.

Q: Will the payment widget slow down my product pages?

A: No, the payment widget is optimized for performance. It loads asynchronously and uses cached configuration data to minimize any impact on page load times.

Q: Can customers switch between payment options after adding to cart?

A: Customers must select their payment option on the product page before adding to cart. To change the payment option, they would need to remove the item and add it again with a different selection.

Q: How do I disable the payment widget for a specific offer?

A: Go to the offer's Payment tab, scroll to the Display section, and uncheck "Show payment & discount savings". Click Save to apply the change.

Q: Does the discount apply to shipping costs?

A: No, preorder discounts configured in STOQ apply only to the product price, not to shipping costs or taxes.

Updated on: 12/02/2026