HustlePay Payment Connector for WooCommerce

Plugin Banner

HustlePay Payment Connector for WooCommerce

by HustlePayDev

Download
Description

HustlePay Payment Connector for WooCommerce connects WooCommerce stores to the HustlePay checkout orchestration service.

The plugin lets customers split a WooCommerce order across available payment methods, while actual payment authorization, processing, settlement, refunds, disputes, and chargebacks remain with the merchant’s configured third-party payment service providers (PSPs), such as Stripe, Mollie, PayPal, or Finix.

HustlePay is not a bank, payment service provider, payment processor, money transmitter, merchant of record, or settlement provider. HustlePay provides a non-custodial checkout orchestration layer that routes payment instructions to the PSP accounts selected and configured by the merchant.

An active HustlePay account is required. Merchants are also responsible for maintaining their own accounts and agreements with the PSPs they choose to use.

External services

This plugin connects to the HustlePay service to create checkout sessions, route payment instructions, and receive payment status callbacks for WooCommerce orders.

Service endpoints used by the plugin:

  • Live API: https://api.hustlepay.net
  • Test API: https://api.hustlepay.dev
  • Service website: https://www.hustlepay.me/
  • Terms of Service: https://www.hustlepay.me/terms-of-service/
  • Privacy Policy: https://www.hustlepay.me/privacy-policy/

When a customer chooses HustlePay and proceeds to payment, the plugin sends the following data to HustlePay so the checkout session can be created and reconciled:

  • WooCommerce order ID, amount, currency, description, return URL, and callback URL.
  • Order line items, fees, shipping lines, and tax lines.
  • Customer name, billing email, billing phone, company, and billing address.
  • The merchant’s configured HustlePay publishable API key, sent as an API header for session creation. The HustlePay secret key is stored in WordPress settings and used to verify signed webhooks.

The plugin does not send this data to HustlePay merely by being installed or activated. The data is sent when the merchant has configured the connector and a customer starts a HustlePay checkout flow.

The plugin does not store full card numbers or CVVs. Payment-method collection and processing are handled through the HustlePay checkout flow and the merchant’s selected PSPs.

Development source

Human-readable source files for the frontend entry points are included in the src directory. The JavaScript and CSS files under assets are compiled build artifacts used by WordPress and WooCommerce at runtime. Runtime JavaScript and CSS assets are bundled with this plugin and are not loaded from third-party CDNs.

  1. Install and activate WooCommerce.
  2. Upload and activate this plugin.
  3. Go to WooCommerce > Settings > Payments.
  4. Enable HustlePay.
  5. Enter the HustlePay publishable and secret API keys for test and/or live mode.
  6. Configure the payment providers you want to use in your HustlePay dashboard.
Is HustlePay a payment provider or payment processor?

No. HustlePay provides checkout orchestration software. Payment processing, settlement, refunds, disputes, chargebacks, and financial compliance remain with the merchant’s selected PSPs.

Which payment methods are supported?

The available methods depend on the PSPs and payment methods configured for the merchant in HustlePay. Common examples include cards, wallets, PayPal, Stripe-backed methods, Mollie-backed methods, and Finix-backed methods where supported by the merchant account.

Does the plugin store card data?

No. The plugin does not store full card numbers or CVVs in WordPress.

Can I test before going live?

Yes. The plugin includes test and live modes. Use the HustlePay test credentials and matching PSP test configuration before enabling live checkout.

What happens if part of a split payment fails?

The checkout session status is returned by HustlePay and the configured PSPs. WooCommerce order status is updated through the HustlePay callback/webhook flow.

Which WooCommerce versions are supported?

The plugin supports WooCommerce 8.0.0 and higher and declares HPOS compatibility.

0.8.5

  • Updated and synchronized the codebase.
  • Minor logic improvements.

0.8.4

  • Made checkout session validation independent of the logged-in WordPress user to support order-pay links across customer, admin, and cached page contexts.

0.8.3

  • Fixed checkout session creation by avoiding WordPress REST cookie nonce handling for the HustlePay order nonce.

0.8.1

  • WordPress.org distribution cleanup.
  • Clarified that HustlePay is a checkout orchestration connector, not a payment processor or PSP.
  • Documented external service usage, transmitted data, Terms of Service, and Privacy Policy.
  • Removed the self-hosted plugin updater from the WordPress.org build.
  • Bundled the HustlePay icon locally instead of loading it from the HustlePay CDN.
  • Fixed the missing admin notice fallback when WooCommerce requirements are not met.

0.8.0

  • Major UI/UX changes and improvements: updated the visual style, added animations, and improved input behavior.
  • Payment methods are now set up as a single list; order and priority depend on dashboard configuration.
  • Added optional appearance configuration for the widget, including fonts, colors, and borders.
Back to top