=== NASS Payment Gateway ===
Contributors: kreatetech
Donate link: https://www.kreatedev.com/donate
Tags: woocommerce, payment gateway, nass, visa, mastercard, iraq, payment processing, 3d secure
Requires at least: 5.0
Tested up to: 6.4
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Integrate NASS E-Payment Gateway with WooCommerce for secure Visa and Mastercard payments with 3D Secure authentication.

== Description ==

The **NASS Payment Gateway** plugin enables WooCommerce stores to accept secure payments through the NASS E-Payment Gateway system. This plugin supports both Visa and Mastercard transactions with full 3D Secure authentication, providing a seamless and secure payment experience for your customers.

**Developed by KREATE TECHNOLOGIES LLC** - Your trusted partner for WordPress and WooCommerce solutions.

= Key Features =

* **Secure Payment Processing** - Full integration with NASS E-Payment Gateway
* **Card Support** - Accept Visa and Mastercard payments
* **3D Secure Authentication** - Enhanced security for all transactions
* **Dual Environment Support** - Sandbox for testing, Production for live transactions
* **Customizable Interface** - Configure payment method title, description, and branding
* **Comprehensive Logging** - Debug mode with detailed transaction logs
* **Admin Dashboard** - Complete transaction management and statistics
* **Responsive Design** - Mobile-friendly checkout experience
* **Real-time Validation** - Instant payment form validation
* **Multi-language Ready** - Translation support included

= Supported Features =

* Product purchases
* Order management
* Payment status tracking
* Transaction logging
* Refund processing (coming soon)
* Webhook handling
* Return URL management

= Requirements =

* WooCommerce 5.0 or higher
* PHP 7.4 or higher
* SSL certificate (required for live transactions)
* Valid NASS merchant account
* WordPress 5.0 or higher

= About KREATE TECHNOLOGIES LLC =

**KREATE TECHNOLOGIES LLC** is a leading web development company based in Wyoming, USA, specializing in WordPress, WooCommerce, and custom web solutions. We provide professional development services and ongoing support for businesses worldwide.

**Contact Information:**
* **Company**: KREATE TECHNOLOGIES LLC
* **Location**: Wyoming, USA
* **Phone**: +1 603 413 2065
* **Website**: https://www.kreatedev.com
* **Email**: info@kreatedev.com

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to Plugins > Add New
3. Search for "NASS Payment Gateway"
4. Click "Install Now" and then "Activate"

= Manual Installation =

1. Download the plugin ZIP file
2. Upload the `nass-payment-gateway` folder to `/wp-content/plugins/`
3. Activate the plugin through the 'Plugins' screen in WordPress
4. Navigate to WooCommerce > Settings > Payments
5. Click on "NASS Payment Gateway" to configure

= Configuration Steps =

1. **Enable the Gateway**
   - Go to WooCommerce > Settings > Payments
   - Find "NASS Payment Gateway" and click "Set up"
   - Check "Enable NASS Payment Gateway"

2. **Basic Settings**
   - Title: Enter the payment method name (default: "NASS Payment Gateway")
   - Description: Add customer-facing description
   - Environment: Select "Sandbox" for testing or "Production" for live

3. **NASS Credentials**
   - Terminal ID: Your 8-digit NASS terminal ID
   - Username: Your NASS account username
   - Password: Your NASS account password
   - Gateway URL: NASS payment gateway URL

4. **Advanced Options**
   - Enable debug logging for troubleshooting
   - Configure webhook URLs if needed

5. **Test the Integration**
   - Place a test order using sandbox credentials
   - Verify payment processing works correctly
   - Check transaction logs in admin panel

== Configuration ==

= Basic Settings =

**Enable/Disable**: Toggle the payment gateway on/off
**Title**: Payment method name shown to customers during checkout
**Description**: Additional information displayed to customers
**Environment**: Choose between Sandbox (testing) and Production (live)

= NASS Credentials =

**Terminal ID**: Your unique 8-digit terminal identifier provided by NASS
**Username**: Your NASS merchant account username
**Password**: Your NASS merchant account password
**Gateway URL**: The NASS payment processing URL

= Default Configuration Values =

Terminal ID: 00099619
Username: 
Password: 
Gateway URL: https://3dsecure.nass.iq/gateway/
Environment: Sandbox

*Note: Replace these with your actual NASS credentials for production use.*

== Testing ==

= Sandbox Environment =

The plugin includes sandbox mode for safe testing. Use the following test credentials:

**Test Card Numbers:**
* **Visa**: 4761349999000039
* **Mastercard**: 5185520050000010

**Test Details:**
* **Expiry Date**: 12/25 or 12/31
* **CVV**: 356
* **Cardholder Name**: Any name

= Testing Process =

1. Set environment to "Sandbox"
2. Enable debug logging
3. Create a test product and add to cart
4. Proceed to checkout
5. Select NASS Payment Gateway
6. Use test card details above
7. Complete the payment process
8. Verify transaction appears in admin logs

== Frequently Asked Questions ==

= Do I need a NASS merchant account? =

Yes, you need a valid NASS merchant account with proper credentials (Terminal ID, Username, Password) to use this plugin. Contact NASS to obtain your merchant account.

= Is this plugin secure? =

Yes, the plugin implements industry-standard security practices:
- All communications use HTTPS encryption
- 3D Secure authentication for enhanced security
- Secure token-based API authentication
- No sensitive card data is stored on your server

= Can I customize the checkout form? =

Yes, you can customize:
- Payment method title and description
- Gateway branding and logos
- Checkout form appearance through CSS
- Template overrides in your theme

= Where can I view transaction logs? =

Transaction logs are available in multiple locations:
- WordPress Admin: WooCommerce > NASS Gateway > Transactions
- Debug logs: WooCommerce > NASS Gateway > Logs
- Individual order details in WooCommerce orders

= How do I enable debug mode? =

1. Go to WooCommerce > Settings > Payments > NASS Gateway
2. Check "Enable logging"
3. Save changes
4. Logs will appear in WooCommerce > NASS Gateway > Logs

= What currencies are supported? =

The plugin supports multiple currencies with automatic conversion:
- USD (United States Dollar)
- EUR (Euro)
- IQD (Iraqi Dinar) - Default
- GBP (British Pound)

= Can I process refunds? =

Refund functionality is planned for future releases. Currently, refunds must be processed through your NASS merchant dashboard.

= How do I get support? =

For technical support, please contact:
- **KREATE TECHNOLOGIES LLC**: info@kreatedev.com
- **Phone**: +1 603 413 2065
- **Website**: https://www.kreatedev.com

For NASS-specific issues, contact your NASS account manager.

== Screenshots ==

1. **Admin Settings Page** - Configure gateway credentials and options
2. **Checkout Page** - Customer payment form with card type detection
3. **Admin Dashboard** - Transaction statistics and management
4. **Transaction Logs** - Detailed payment history and debugging
5. **Mobile Checkout** - Responsive design for mobile devices
6. **Payment Steps** - Clear payment process guidance

== Changelog ==

= 1.0.0 - 2025-01-01 =
* **Initial Release**
* Complete NASS E-Payment Gateway integration
* Support for Visa and Mastercard payments
* 3D Secure authentication implementation
* Sandbox and production environments
* Comprehensive admin dashboard
* Transaction logging and management
* Responsive checkout form design
* Debug mode and error handling
* Multi-language support framework
* WordPress and WooCommerce compatibility
* Security enhancements and validation
* Mobile-optimized user interface

== Upgrade Notice ==

= 1.0.0 =
Initial release of the NASS Payment Gateway plugin. Install now to start accepting secure payments through NASS E-Payment Gateway.

== Support ==

= Technical Support =

For plugin-related support, please contact **KREATE TECHNOLOGIES LLC**:

* **Email**: info@kreatedev.com
* **Phone**: +1 603 413 2065
* **Website**: https://www.kreatedev.com
* **Business Hours**: Monday-Friday, 9 AM - 6 PM EST

= NASS Gateway Support =

For NASS-specific account or gateway issues:
* Contact your assigned NASS account manager
* Refer to NASS merchant documentation
* Check NASS system status and announcements

= Documentation =

Complete documentation is available at:
* Plugin settings pages include contextual help
* Inline documentation in admin interface
* Developer hooks and filters documentation

== Privacy ==

This plugin processes payment information through the NASS Payment Gateway. Please review and comply with:

* NASS Privacy Policy and Terms of Service
* PCI DSS compliance requirements
* Local data protection regulations (GDPR, etc.)
* Your website's privacy policy updates

**Data Handling:**
- No sensitive card data is stored locally
- Transaction IDs and status are logged for order management
- Customer payment information is transmitted securely to NASS
- Debug logs may contain transaction details (disable in production)

== Developer Information ==

= Hooks and Filters =

The plugin provides various hooks for developers:

```php
// Modify transaction data before sending to NASS
apply_filters('nass_gateway_transaction_data', $data, $order);

// Custom payment form validation
apply_filters('nass_gateway_validate_payment', $is_valid, $order);

// Modify API request parameters
apply_filters('nass_gateway_api_request', $request_data, $endpoint);

= Template Override =
Override checkout form template by copying:
/wp-content/plugins/nass-payment-gateway/templates/checkout-form.php
To:
/wp-content/themes/your-theme/woocommerce/nass-payment-gateway/checkout-form.php
= Custom Styling =
Add custom CSS to your theme:
css.nass-payment-form {
    /* Your custom styles */
}
Developed with ❤️ by KREATE TECHNOLOGIES LLC
Your trusted partner for WordPress and WooCommerce solutions

This is the complete `readme.txt` file with all the necessary information about your NASS Payment Gateway plugin, properly formatted for WordPress plugin directory standards and including your company information.