Skip to main content

Payments

Located at Stores → Configuration → Byte8 → Pre-Order → Payment Settings.

This is the core configuration of the module — what fraction of the price is captured at pre-order time vs. deferred to ship day.

Fields​

FieldPathDefaultNotes
Payment Typebyte8_preorder/payment/typeFullFull / Partial Percent / Partial Fixed
Deposit Typebyte8_preorder/payment/deposit_typePercentPercent / Fixed (only when payment type is "partial")
Deposit Amountbyte8_preorder/payment/deposit_amount25A percentage (e.g. 25) or a currency amount (e.g. 49.00)

The three modes​

Full payment​

  • Customer pays 100% at checkout.
  • No vault capture needed (nothing to defer).
  • Pre-order moves directly to awaiting_stock and auto-completes when stock arrives.

When to use it: you're sure the launch is happening, you want the cash up front, and you're comfortable refunding cancellations.

Partial — percentage​

  • Customer pays X% at checkout. Default 25%.
  • Balance captured later via vault (recommended) or via a follow-up payment link.

When to use it: standard launch / drop scenario. 25–50% is the typical merchant pick.

The percentage is applied to the product subtotal (excl. shipping, excl. tax — depends on your tax-config setting; see Magento totals docs). Tax and shipping are fully owed at the deposit stage so the merchant covers their dispatch cost up front.

Partial — fixed​

  • Customer pays a fixed amount per item (e.g. €49 deposit on a €450 console).
  • Balance captured later.

When to use it: high-ticket items where a flat deposit reads better than "11.0%". Common for furniture, electronics, custom-build categories.

Per-product overrides​

The global deposit % / fixed amount is the default. Per product, you can override via two product attributes:

AttributeTypeNotes
preorder_deposit_typeSelectInherit / Percent / Fixed — leaves inherit and global wins.
preorder_deposit_amountNumberUsed only when preorder_deposit_type ≠ inherit.

This lets you charge a 50% deposit on the top-end SKU and keep the standard 25% on the rest of the catalog without cloning categories.

Per-customer overrides​

VIP and wholesale customers can have a deposit override at the customer level — e.g. a wholesale account always pays 100% upfront, or a VIP-tier customer always pays 0% (full credit).

See Customer overrides for the customer-attribute setup.

What customers see​

The PDP info block renders the breakdown — e.g.:

€450.00  product price
€112.50  due now (25% deposit)
€337.50  due on shipment

The cart and checkout summary repeat the same line. The order confirmation email and the admin order view both call out the deferred balance separately so accounting / customer service have no ambiguity.

Tax handling​

The deposit is calculated excluding tax by default. Tax is owed in full on the deposit transaction so VAT reporting is straightforward — the deposit invoice records the tax line, and the completion invoice (when the balance captures) records the rest.

If you need a different tax behaviour (e.g. tax distributed proportionally between deposit and balance), open a support ticket — the totals collector has the seam to support that, but it's not the default.