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
- The buyer places an order in WooCommerce.
- The plugin creates a Mint payment using your Mint secret key.
- Mint returns a hosted
payment_url. - WooCommerce redirects the buyer to Mint hosted checkout.
- Mint returns the buyer to the WooCommerce order confirmation page for that order, typically the thank-you page.
- The plugin refreshes the Mint payment status and updates the order.
Required configuration
The plugin needs:
Mint API URLMint Secret KeyMint 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.shThis produces:
woocommerce-plugin/dist/mint-for-woocommerce.zip
Then install it in WordPress:
- In WordPress admin, go to
Plugins -> Add Plugin -> Upload Plugin. - Upload
mint-for-woocommerce.zip. - Activate
Mint for WooCommerce. - Go to
WooCommerce -> Settings -> Payments -> Mint. - 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.