Wayl Checkout is a payment facilitator plugin for WooCommerce that enables merchants to accept online payments through multiple local and international payment methods in one unified solution.

Features:
* Accept payments from customers in Iraq and internationally
* Support for Iraqi Dinar (IQD) and US Dollar (USD)
* Multiple payment methods: Iraqi local and international Visa/MasterCard, ZainCash, FIB (First Iraqi Bank), and FastPay
* Arabic and English language support
* Secure payment processing with real-time notifications
* Easy setup and configuration

About Wayl Checkout:
* Payment Facilitator – Built for the Iraqi market
* All Payment Methods in One – Aggregate Iraqi local and international Visa/MasterCard, ZainCash, FIB, and FastPay in a single checkout solution
* Secure & Reliable – Enterprise-grade security with webhook signature verification
* Easy Integration – Simple setup process, no technical expertise required
* Real-time Updates – Instant payment notifications via webhooks
* Full Refund Support – Process refunds directly from WooCommerce orders

Key Features:

Multiple Payment Methods – Accept Iraqi local and international Visa/MasterCard, ZainCash, FIB, and FastPay payments
Iraqi Dinar Support – Full support for IQD currency with USD conversion
Secure Processing – Enterprise-grade security with webhook signature verification
Real-time Notifications – Instant payment status updates via webhooks
Refund Management – Process full refunds directly from WooCommerce order management
Bilingual Support – Arabic and English language interface
Comprehensive Logging – Detailed logs for debugging and transaction tracking
Easy Configuration – Simple setup wizard and intuitive admin interface
Mobile Optimized – Responsive checkout experience for all devices
WooCommerce Native – Seamless integration with WooCommerce order management

Requirements:

WordPress 5.0 or higher
WooCommerce 5.0 or higher
PHP 7.4 or higher
SSL certificate (for production use)

External Services

This plugin connects to the Wayl payment API to create payment links and process transactions.

Service: Wayl Payment API
URL: https://api.thewayl.com

Data sent:
– Order ID
– Order total
– Currency
– Line items
– Redirect URL
– Webhook URL

Data is sent:
– When customer places an order
– When verifying payment via webhook

Third-Party Service Information

This plugin integrates with Wayl’s payment processing service to enable secure payment transactions.

What is Wayl?

Wayl is a payment processing service that provides secure checkout functionality for e-commerce transactions, with a focus on supporting payments in Iraq (IQD) and other currencies.

What data is sent to Wayl and when?

The following data is transmitted to Wayl’s API (https://api.thewayl.com/api/v1):

During Checkout (when customer clicks to pay):
* Order reference ID (generated by the plugin)
* Order total amount and currency
* Line items (products, shipping, taxes, fees, discounts)
* Customer redirect URL (order confirmation page)
* Webhook URL (for payment status updates)
* Payment page language preference
* Product names and images (if available)

During Webhook Processing (when Wayl sends payment status):
* Webhook signature verification
* Payment status updates
* Order status updates

This data is sent only when a customer initiates a payment during the checkout process. The plugin does not send any data to Wayl until a payment is initiated.

What data is received from Wayl?

When Wayl processes a payment, it sends webhook notifications to your site containing:

Payment status (Paid, Failed, etc.)
Payment method and processor information
Transaction details
Customer information (name, phone) if provided during payment

Privacy and Service Terms:

Wayl Privacy Policy: https://www.wayl.io/privacy
Wayl Terms of Service: https://www.wayl.io/terms
Wayl Website: https://www.wayl.io/

User Consent:

By using this payment method, customers consent to having their payment information processed by Wayl according to Wayl’s privacy policy and terms of service. The plugin itself does not store payment card details or sensitive payment information.

Privacy Statement:

This plugin does not track users. No user tracking, analytics, or personal data collection is performed by this plugin beyond what is necessary for payment processing through Wayl’s service.

Support

Need Help?

Email Support: [email protected]
WhatsApp Support: +964 775 227 7781
Website: https://www.wayl.io
Dashboard: https://dashboard.thewayl.com

Common Issues:

Payment not processing: Check that your API key is correct and your account is active
Webhook not working: Ensure your server can receive POST requests and the webhook URL is accessible
Currency conversion issues: Make sure your WooCommerce store currency is set to USD when using IQD mode
Payment methods not showing: Verify your API key is valid and your account has payment methods enabled

Privacy & Security

Data Privacy:
* This plugin does not store payment card details or sensitive payment information
* Payment data is processed securely through Wayl’s encrypted API
* Customer consent is required for payment processing
* No user tracking or analytics are performed by this plugin

Security Features:
* Webhook signature verification
* Secure HTTPS communication
* Input sanitization and output escaping
* WordPress security best practices
* Regular security updates

Third-Party Services:
* This plugin integrates with Wayl’s payment processing service
* Payment data is transmitted to Wayl’s secure API (https://api.thewayl.com)
* Wayl Privacy Policy: https://www.wayl.io/privacy
* Wayl Terms of Service: https://www.wayl.io/terms

Webhook Setup

The plugin automatically generates a webhook secret and URL. The webhook URL will be:
https://yourdomain.com/?wc-api=waylchp_webhook

Make sure this URL is accessible and your server can receive POST requests.

Logging

When logging is enabled, the plugin creates log files in:
wp-content/uploads/wayl-checkout/

Log files are created daily and include:
– API requests and responses
– Webhook processing
– Payment status updates
– Error messages

Configuration

Required Settings:

API Key (Required)
- Contact [email protected] or WhatsApp +964 775 227 7781 to obtain your Merchant Token API Key
- Enter the API key in the “API Key” field
Language (Optional)
- Choose between Arabic (ar) or English (en) for the payment page
- Default: English
Currency Mode (Optional)
- Site Currency: Use your store’s default currency
- Force IQD: Convert USD to Iraqi Dinar (requires USD as site currency)
Logging (Optional)
- Enable to log API requests and responses for debugging
- Logs are stored in wp-content/uploads/wayl-checkout/
- Recommended: Enable during setup, disable in production

Recommended Settings:

Enable the payment method for your store
Set a clear payment method title and description
Test the integration before going live
Monitor your first few transactions

Developer Information

Plugin Structure:
* Main plugin file: wayl-checkout.php
* Payment gateway class: includes/class-waylchp-payment-gateway.php
* API client: includes/class-waylchp-api.php
* Webhook handler: includes/class-waylchp-webhook-handler.php
* Logger: includes/class-waylchp-logger.php

Hooks & Filters:
* waylchp_payment_channels – Filter payment channels before display
* waylchp_checkout_data – Filter checkout data before API call
* waylchp_webhook_data – Filter webhook data before processing

API Endpoints:
* Checkout: https://api.thewayl.com/api/v1/checkout
* Refund: https://api.thewayl.com/api/v1/refunds
* Webhook: https://yourdomain.com/?wc-api=waylchp_webhook

Requirements:
* WordPress 5.0+
* WooCommerce 5.0+
* PHP 7.4+
* SSL certificate (for production)
* cURL extension enabled