Advanced Product Fields
Split Pay includes Advanced Product Fields price adjustments when APF stores them in the WooCommerce order line total.
Overview#
Advanced Product Fields (APF) for WooCommerce lets you add custom fields to your products — such as text inputs, dropdowns, checkboxes, and file uploads — many of which can modify the product price. Price adjustments that APF stores in the WooCommerce order line total are automatically reflected in Split Pay percentage calculations.
How it works#
When a customer selects options that modify the product price (e.g., choosing a premium material that adds $10), APF updates the WooCommerce cart line item total to include those surcharges. Split Pay reads the final line item total — which already includes APF adjustments — when calculating the transfer amount.
Example#
| Component | Amount |
|---|---|
| Base product price | $50.00 |
| APF: Premium material (+$10) | $10.00 |
| APF: Gift wrapping (+$5) | $5.00 |
| Line item total | $65.00 |
| Transfer at 20% | $13.00 |
The transfer is calculated on the $65 line item total, not the $50 base price. This ensures the vendor receives their correct share of the full amount charged.
No special configuration is needed. As long as APF adds its price adjustments to the WooCommerce line item total (which is the default behavior), Split Pay will automatically account for them.
Supported field types#
Any APF field type is compatible when its price adjustment is included in the WooCommerce order-line total that Split Pay reads. Common examples include:
- Select / Dropdown — Options with price adjustments
- Radio buttons — Choices with different price modifiers
- Checkboxes — Add-on options with surcharges
- Number fields — Quantity-based pricing calculations
- Text / Textarea — Custom text with associated fees (e.g., engraving)
- File upload — Upload fees
Fixed amount vs. percentage transfers#
The interaction between APF surcharges and your transfer type:
- Percentage transfers — The percentage is applied to the eligible line-item total, including APF adjustments recorded there. The vendor's share scales proportionally with the customer's selections.
- Fixed amount transfers — A positive APF surcharge does not increase the configured fixed amount. If the eligible line total is lower than that amount, Split Pay caps the transfer at the line total.
If a positive APF surcharge should not increase the vendor payment, use a fixed amount transfer type. If the vendor should share in surcharge revenue, use a percentage transfer type. A fixed transfer is still capped when the eligible line total is lower.
Requirements#
- Advanced Product Fields must store its price adjustment in the WooCommerce order line total. That is the amount Split Pay reads.
- No separate Split Pay integration switch is required. This price handling applies to normal Free or PRO percentage rules; fixed amounts and product- or variation-level rules still require Split Pay PRO.
Troubleshooting#
If APF surcharges are not being included in transfer calculations:
- Verify that the APF fields are set to modify the product price (check the "Pricing" option in each field's settings).
- Confirm the WooCommerce order shows the correct line item total (including APF adjustments) under WooCommerce → Orders.
- Record the APF version and confirm the order line total first. Update APF only when its release notes or a current test proves that the exact issue is fixed.