Description
GrineoPay Crypto Gateway with Instant Payouts lets merchants accept cryptocurrency payments directly on their store using supported crypto assets and networks routed through GrineoPay.
This plugin is built for merchants who want a crypto-only payment solution with a non-custodial checkout experience, wallet-based payments, and instant payout routing logic through the GrineoPay ecosystem.
With this plugin, customers can select supported cryptocurrencies during checkout and complete payment using their own wallet, while merchants receive the original cryptocurrency paid by the customer based on their configured GrineoPay wallet setup.
Before You Start
To use this plugin, you will need a GrineoPay merchant account.
Create or access your account here:
* GrineoPay Login: https://grineopay.com/login
Once your account is ready, you will need:
* your Crypto API Key
* your Crypto API Secret
* your Crypto Webhook Secret
* active wallet addresses saved in your GrineoPay merchant dashboard for the assets and networks you want to accept
Key Benefits for Merchants
- Crypto-only checkout
- Fully non-custodial payment flow
- Instant payout routing
- Receive the original cryptocurrency paid by the customer
- Wallet-backed crypto visibility
- WooCommerce classic checkout support
- WooCommerce Blocks checkout support
- Optional modal checkout
- Webhook-based order status updates
- Merchant-configurable minimum order amount
- Checkout discount support
- Remote wallet sync from GrineoPay
- Admin diagnostics panel via
?grineopay_debug=1
Supported Cryptocurrencies and Networks
Current supported options include:
* Bitcoin (BTC) — Bitcoin
* Ethereum (ETH) — Ethereum
* Solana (SOL) — Solana
* Litecoin (LTC) — Litecoin
* Monero (XMR) — Monero
* Dogecoin (DOGE) — Dogecoin
* Cardano (ADA) — Cardano
* Tron (TRX) — Tron
* Tether (USDT) — Tron
* Tether (USDT) — Ethereum
* Tether (USDT) — Polygon
* Tether (USDT) — BNB Smart Chain
* USD Coin (USDC) — Polygon
* USD Coin (USDC) — Ethereum
* USD Coin (USDC) — BNB Smart Chain
* USD Coin (USDC) — Arbitrum
* USD Coin (USDC) — Optimism
* USD Coin (USDC) — Solana
Wallet-Based Crypto Visibility
This plugin only shows crypto methods at checkout when they are actually payout-ready.
A crypto option appears only if:
1. it is enabled in the WooCommerce gateway settings, and
2. the merchant has an active matching wallet configured in GrineoPay for that exact crypto/network combination
This helps prevent customers from choosing unavailable crypto methods and ensures checkout stays synchronized with the merchant’s GrineoPay wallet configuration.
Useful Features
- Remote wallet-backed asset lookup from GrineoPay
- Fast reflection of merchant wallet changes on checkout
- Support for WooCommerce subscriptions compatibility flags
- Admin order crypto metadata display
- Discount support when GrineoPay is selected at checkout
- Debug panel for wallet visibility, credentials, and minimum order diagnostics
Privacy, Security & Compliance
This gateway processes payment information with enterprise-level safety:
* End-to-end SSL/TLS encryption
* No storage of sensitive card information on your server
* Secure webhook signature verification
* Crypto checkout backed by merchant wallet validation
* Server-side validation for crypto asset availability
* Automatic sanitization of stored API credentials to prevent silent authentication failures caused by hidden or invisible characters
* Non-custodial customer payment flow
* Fully GPL-compatible and WooCommerce-friendly
Helpful Links
- Create / Access Account: https://grineopay.com/login
- Merchant Dashboard: https://grineopay.com/merchant-dashboard/
- API Documentation: https://grineopay.com/api-docs
- Supported Countries: https://grineopay.com/countries
- Supported Industries: https://grineopay.com/industries
- Privacy Policy: https://grineopay.com/privacy-policy
- Terms of Service: https://grineopay.com/terms-of-service
Installation
- Upload the plugin files to the
/wp-content/plugins/grineopay-crypto-gateway-with-instant-payouts/directory, or install through the WordPress plugins screen. - Activate the plugin through the Plugins screen in WordPress.
- Create or log in to your merchant account at https://grineopay.com/login.
- In your GrineoPay merchant environment, configure the wallet addresses for the crypto assets and networks you want to accept.
- Go to WooCommerce Settings Payments.
- Enable GrineoPay Crypto Gateway with Instant Payouts.
- Enter your Crypto API Key and Crypto API Secret from your GrineoPay merchant account.
- Copy the WooCommerce webhook callback URL shown in the gateway settings.
- Add that webhook URL to your GrineoPay merchant webhook configuration.
- Paste your Crypto Webhook Secret into the WooCommerce gateway settings.
- Save your settings.
- Optionally configure:
- the minimum order amount
- modal checkout
- enabled cryptocurrencies
- checkout discount settings
FAQ
-
Do I need a GrineoPay account before using this plugin?
-
Yes. You must create or access a GrineoPay merchant account before using the plugin.
Login here:
https://grineopay.com/loginYou will need your merchant crypto credentials and active wallet configuration from GrineoPay in order to complete setup.
-
What are the available payment methods?
-
This plugin is a crypto-only payment gateway.
Customers pay directly using supported cryptocurrencies from their own wallet. The plugin does not process card payments, debit cards, Apple Pay, or Google Pay.
-
What cryptocurrencies are supported?
-
Supported options include:
* BTC
* ETH
* SOL
* LTC
* XMR
* DOGE
* ADA
* TRX
* USDT on supported networks
* USDC on supported networksThe exact list shown at checkout depends on:
1. the gateway settings, and
2. the merchant’s active wallets configured on GrineoPayIf only Bitcoin is visible, check:
* the merchant has saved all desired wallets in the GrineoPay dashboard
* the selected enabled assets include those coins/networks
* the GrineoPay remote API is returning those wallets -
How quickly do wallet changes reflect on checkout?
-
This plugin is configured to fetch wallet-backed assets fresh from GrineoPay with no persistent transient caching by default, so wallet additions or removals should reflect on the next checkout reload.
Because the WooCommerce store is separate from the GrineoPay platform, checkout visibility depends on the latest wallet-backed asset response from the remote GrineoPay API.
-
What is the minimum order amount?
-
The minimum order amount is configurable by the merchant in the WooCommerce payment gateway settings.
If the cart total is below that configured minimum, GrineoPay will be hidden at checkout.
Set the minimum to
0if you want GrineoPay to always be visible regardless of cart total. -
What is the maximum order amount?
-
There is no single universal fixed maximum in the plugin itself.
Practical limits may depend on:
* blockchain conditions
* wallet capabilities
* supported assets
* remote payment provider constraints
* risk and operational controls -
How does settlement work?
-
GrineoPay settles in the original cryptocurrency paid by the customer.
If a customer pays in BTC, the merchant receives BTC.
If a customer pays in ETH, the merchant receives ETH.This is designed for merchants who want original-coin settlement rather than automatic fiat conversion.
-
What payout wallet do I need?
-
You need a wallet that supports the cryptocurrencies and blockchain networks you want to accept through GrineoPay.
Because the merchant receives the original coin paid by the customer, the merchant must configure wallet addresses that match the enabled crypto asset/network combinations. We support payouts in BTC, ETH, SOL, LTC, XMR, DOGE, ADA, TRX, USDT on supported networks, USDC on supported networks
-
What are the processing fees?
-
Processing fee is 0.5% per transaction. No subscriptions. No hidden fees.
-
Which countries are supported?
-
GrineoPay supports merchants and customers in most countries worldwide, excluding restricted jurisdictions.
For the current supported and restricted country list, visit:
https://grineopay.com/countries -
Is GrineoPay custodial?
-
The checkout flow is designed to be non-custodial in customer experience terms, with wallet-based payment handling and direct merchant payout routing based on configured wallets.
-
Do users need KYB or KYC?
-
Because GrineoPay’s crypto checkout flow is 100% non-custodial, we do not require KYB or KYC.
-
How quickly can I access my funds?
-
Timing depends on:
* the blockchain network
* confirmation timing
* transaction conditions
* the GrineoPay payment routing flowThe plugin itself is designed for instant payout routing logic, but practical timing always depends on actual network confirmation and remote platform processing.
-
How secure is GrineoPay’s payment system?
-
This plugin is built around:
* webhook signature verification
* remote wallet-backed asset validation
* checkout-level crypto selection validation
* secure remote API communication
* credential sanitization
* WooCommerce-safe order state handling -
How do I integrate GrineoPay with my store?
-
Install and activate the plugin, create your GrineoPay account, configure your wallets, add your API credentials in WooCommerce, and connect the webhook URL shown in the settings.
Then test checkout using a supported cryptocurrency.
-
What happens if a customer’s payment fails?
-
If the remote payment does not complete successfully, the WooCommerce order remains unpaid or is marked failed depending on the webhook status returned by GrineoPay.
-
What businesses does GrineoPay support?
-
GrineoPay supports a range of merchant categories depending on its current policies, supported countries, and risk criteria.
For the latest industries information, visit:
https://grineopay.com/industries -
How do I debug setup issues?
-
As an administrator, add:
?grineopay_debug=1to your checkout URL.
This will display a diagnostic panel showing:
* whether the gateway is enabled
* whether your credentials are configured and clean
* whether wallet-backed assets are being returned
* whether your cart meets the minimum order requirement
Reviews
There are no reviews for this plugin.
Contributors & Developers
“GrineoPay Crypto Gateway with Instant Payouts” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “GrineoPay Crypto Gateway with Instant Payouts” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.1
- General maintenance and version bump.
1.0.0
- Initial production release.
- Added crypto-only WooCommerce gateway support.
- Added wallet-backed crypto visibility.
- Added WooCommerce Blocks support.
- Added recurring/subscription support flags.
- Added checkout discount support.
- Added modal checkout support.
- Added debug diagnostics panel.
- Added webhook-based order updates.
- Added fresh remote wallet synchronization behavior.













