=== PayStarSea Crypto Payment Gateway ===
Contributors: paystarsea, jobworksky
Tags: cryptocurrency, payment gateway, woocommerce, bitcoin, usdt
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept cryptocurrency payments (USDT, BTC, ETH) on your WooCommerce store via PayStarSea payment gateway.

== Description ==

PayStarSea Crypto Payment Gateway enables your WooCommerce store to accept cryptocurrency payments including USDT, Bitcoin, and Ethereum across multiple blockchain networks (TRC20, ERC20, BEP20).

= Features =

* **Multiple Cryptocurrencies**: Accept USDT, BTC, ETH
* **Multiple Networks**: Support for TRC20 (TRON), ERC20 (Ethereum), BEP20 (BSC)
* **Secure Payments**: Industry-standard HMAC-SHA256 signature verification
* **Real-time Monitoring**: Automatic payment detection and order updates
* **Webhook Integration**: Instant payment notifications
* **QR Code Payments**: Easy mobile wallet scanning
* **Auto Order Completion**: Automatically complete orders after payment confirmation
* **Detailed Logging**: Comprehensive transaction and API logs
* **Multi-language Support**: Ready for translation

= How It Works =

1. Customer selects cryptocurrency payment at checkout
2. Customer chooses preferred cryptocurrency and network
3. System generates unique payment address and amount
4. Customer sends payment from their wallet
5. Payment is automatically detected and verified
6. Order is automatically updated and completed

= Requirements =

* WordPress 5.8 or higher
* WooCommerce 6.0 or higher
* PHP 7.4 or higher
* SSL certificate (HTTPS) required for production
* PayStarSea merchant account (register at https://www.paystarsea.com)

= External Services =

This plugin connects to the PayStarSea payment processing platform to create orders, assign payment addresses, verify payments, and receive webhook status updates.

Data sent to PayStarSea when a customer pays with cryptocurrency includes order amount, currency, selected coin and network, store order reference, and callback URLs. Webhook payloads from PayStarSea include order status, transaction hash, and payment amounts. API credentials configured in WooCommerce settings are used for authenticated requests.

* API endpoint: https://openapi.paystarsea.com
* PayStarSea website: https://www.paystarsea.com
* Terms of service: https://www.paystarsea.com/terms
* Privacy policy: https://www.paystarsea.com/privacy

QR codes on the payment page are generated locally in the browser using the bundled qrcode.js library (MIT license). No third-party QR code API is used.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/paystarsea-crypto-payment-gateway/` directory, or install through WordPress plugins screen
2. Activate the plugin through 'Plugins' screen in WordPress
3. Go to WooCommerce > Settings > Payments > PayStarSea Crypto Payment
4. Enter your PayStarSea API credentials (API Key and API Secret)
5. Enter your Merchant No to load available cryptocurrencies
6. Select which coins and networks you want to accept
7. Configure payment settings and enable the gateway
8. Test the connection to ensure proper setup

== Frequently Asked Questions ==

= Do I need a PayStarSea account? =

Yes, you need to register for a merchant account at https://www.paystarsea.com to get your API credentials.

= Which cryptocurrencies are supported? =

Currently supports USDT, USDC, Bitcoin (BTC), Ethereum (ETH), and TRX across multiple networks including TRC20, ERC20, BEP20, Bitcoin, and Polygon.

= Are there any transaction fees? =

Please check PayStarSea's pricing page for current fee structure.

= Can I customize which cryptocurrencies to accept? =

Yes, you can select specific coins and networks based on your merchant wallet configuration.

= Is this plugin secure? =

Yes, the plugin uses industry-standard HMAC-SHA256 signature verification for all API communications and webhook callbacks.

= Can I test before going live? =

Yes, the plugin includes a test mode for development and testing purposes.

== Screenshots ==

1. Payment gateway API settings in WordPress
2. Cryptocurrency and network configuration
3. PayStarSea merchant dashboard
4. API key and webhook configuration
5. Wallet address management

== Changelog ==

= 1.0.0 =
* Initial release
* Support for USDT, USDC, BTC, ETH, TRX, SOL
* Multiple blockchain networks: TRC20, ERC20, BEP20, Polygon, Bitcoin, Solana
* HMAC-SHA256 signed API communication and webhook verification
* Real-time payment detection with automatic order updates
* Client-side QR code generation (bundled qrcode.js, MIT license)
* WooCommerce Blocks checkout integration
* Smart network selection with minimum order amount enforcement
* Partial payment detection with dynamic countdown refresh
* Comprehensive transaction and API logging
* Full WordPress.org coding standards compliance

== Upgrade Notice ==

= 1.0.0 =
Initial release of PayStarSea Crypto Payment Gateway.

== Support ==

For support, please email contact@paystarsea.com, visit https://www.paystarsea.com or use the WordPress.org plugin support forum.

== Privacy Policy ==

This plugin does not collect or store any personal data. All payment processing is handled securely by PayStarSea platform.
