Skip to content
  • There are no suggestions because the search field is empty.

Mint Payments × WooCommerce — Supported Integration Methods


Mint Payments currently supports WooCommerce’s classic (shortcode-based) checkout and cart pages. The plugin does not yet support the WooCommerce Checkout block (block-based Cart & Checkout). If your site uses the Checkout block, Mint HPP will not appear at checkout until you switch that page to the classic shortcode version.

What's supported v not supported

Integration surface

 

Status

 

Classic Checkout page using shortcode [woocommerce_checkout]

✅ Supported

Classic Cart page using shortcode [woocommerce_cart]

✅ Supported

Checkout block (block-based checkout)

❌ Not supported

Cart block (block-based cart)

❌ Not supported

Tip: You can still use the WordPress block editor. Add a Shortcode block and place the classic WooCommerce shortcodes inside it.

Recommended setup (classic checkout)

Follow these steps to ensure your checkout uses the supported shortcode flow:

  1. Pages → Checkout → Edit
    • If you see a Checkout block, remove it.
    • Add a Shortcode block and paste:

    [woocommerce_checkout]

  2. Pages → Cart → Edit (optional but recommended)
    • If you see a Cart block, remove it.
    • Add a Shortcode block and paste:

    [woocommerce_cart]

    WooCommerce → Settings → Advanced
    • Confirm Checkout page and Cart page are set to the pages above.

  3. WooCommerce → Settings → Payments
    • Ensure Mint HPP is enabled and configured.

  4. Update/Publish the pages and test your checkout.

 

How to tell if you’re using the Checkout block

  • In the editor, the page shows a Checkout block composed of inner blocks (e.g., Payment Options, Checkout Fields, Totals).

  • In this case, switch to the shortcode approach as described above to make Mint HPP appear.

 

Frequently asked questions

Does Mint HPP work with the latest WooCommerce?
Yes—when your checkout uses the classic shortcode. The block-based Checkout is not supported yet.

Can I keep using the block editor?
Yes. Add a Shortcode block and place [woocommerce_checkout] (and [woocommerce_cart]) inside. You’ll still be using the classic checkout flow.

Why doesn’t Mint HPP show when I use the Checkout block?
The block-based Checkout only displays gateways that are explicitly compatible with the Checkout block. Mint HPP currently integrates with the classic (shortcode) checkout.

Will Mint HPP support the Checkout block in future?
We’re evaluating support. There’s no ETA yet. We’ll announce when block compatibility becomes available.

 

Troubleshooting checklist

  • Gateway not shown even with shortcode?
    • WooCommerce → Settings → Payments: Mint HPP is Enabled.
    • API credentials / keys are present and valid.
    • Clear caches (server + plugin + CDN), then test again.
    • Temporarily switch to a default theme and disable other checkout/optimization plugins to rule out conflicts.
    • Review your error logs for gateway-related messages.

  • Editor still shows the block checkout
    • Remove the block and insert a Shortcode block with [woocommerce_checkout].
    • Confirm page assignments under WooCommerce → Settings → Advanced.

 

References (for store owners)

  • WooCommerce shortcodes overview — including [woocommerce_checkout] and [woocommerce_cart], and how to use shortcodes inside a Shortcode block.

  • WooCommerce Checkout block overview — explains the inner blocks and that Payment Options displays gateways that are available and compatible with the Checkout block.

 

Need help?

If you’d like us to verify your setup or switch your pages to the supported configuration, contact Mint Payments Support:

We’re happy to help you get up and running quickly.