Skip to content

WooCommerce

Mint for WooCommerce is a hosted-payments integration for WooCommerce stores.

It lets WooCommerce create Mint payments on the server side, redirect buyers to a Mint-hosted payment page, and sync payment status back into the WooCommerce order.

When to use it

Choose the WooCommerce plugin if:

  • your storefront runs on WooCommerce
  • you want Mint hosted payments rather than a custom embedded checkout
  • you want the WordPress server to create Mint payments with your secret key

How it works

  1. The buyer places an order in WooCommerce.
  2. The plugin creates a Mint payment using your Mint secret key.
  3. Mint returns a hosted payment_url.
  4. WooCommerce redirects the buyer to Mint hosted checkout.
  5. Mint returns the buyer to the WooCommerce order confirmation page for that order, typically the thank-you page.
  6. The plugin refreshes the Mint payment status and updates the order.

Required configuration

The plugin needs:

  • Mint API URL
  • Mint Secret Key
  • Mint Checkout ID

Bundled default:

  • Mint API URL = https://api.getmint.money

Recommended production setup:

  • keep the secret key out of the WordPress admin UI
  • define configuration in wp-config.php

Example:

php
define('MINT_WOOCOMMERCE_API_URL', 'https://api.getmint.money');
define('MINT_WOOCOMMERCE_SECRET_KEY', 'sk_live_or_test_xxx');
define('MINT_WOOCOMMERCE_CHECKOUT_ID', 'your-checkout-id');

Testing

  • Keep the plugin pointed at https://api.getmint.money.
  • Test the integration with a Mint test checkout.
  • Move to a live checkout when you are ready for production traffic.

Installing the Mint plugin

Mint is installed in WordPress as a zip plugin package.

If you are working from source, build the plugin archive with:

bash
./woocommerce-plugin/build.sh

This produces:

  • woocommerce-plugin/dist/mint-for-woocommerce.zip

Then install it in WordPress:

  1. In WordPress admin, go to Plugins -> Add Plugin -> Upload Plugin.
  2. Upload mint-for-woocommerce.zip.
  3. Activate Mint for WooCommerce.
  4. Go to WooCommerce -> Settings -> Payments -> Mint.
  5. Configure the Mint API URL, secret key, and checkout ID.

Current limitations

The current plugin intentionally stays narrow:

  • classic WooCommerce checkout only
  • no WooCommerce Blocks support yet
  • no Mint webhook push integration yet
  • no refunds or subscriptions yet

Operational notes

  • The WordPress server must be able to reach Mint over outbound HTTPS.
  • The Mint secret key and checkout ID must belong to the same Mint organization.
  • For real end-to-end crypto payment flow, the target Mint checkout should already be published on-chain.
  • Customer integrations should not depend on a separate dev Mint platform.
  • The hosted payment return URL brings the buyer back to the WooCommerce order confirmation page, not necessarily the page they originally came from.