BalePay - Bale Messenger Payment Gateway for WooCommerc

AryaPortal BalePay is a professional WooCommerce payment gateway that enables Iranian online stores to accept payments through Bale Messenger. It supports both Bale in-chat wallet/invoice payments and card-to-card bank transfers with receipt verification, combined with automatic order management, secure webhook validation, account linking, transaction management, and a powerful RTL-friendly admin dashboard.

Product Description

Accept WooCommerce Payments Directly Through Bale Messenger

AryaPortal BalePay transforms Bale Messenger into a complete payment channel for WooCommerce stores.

Designed specifically for the Iranian e-commerce market, the plugin provides two independent payment methods: automated Bale in-chat payments and manually verified card-to-card bank transfers.

Customers can complete their payment directly within Bale or transfer the required amount to one of the store's configured bank cards and upload their payment receipt. The plugin then handles order status, payment validation, receipt management, notifications, and transaction records automatically.

This makes AryaPortal BalePay a flexible solution for WooCommerce stores that want to offer customers a modern Bale-based payment experience while retaining a reliable manual payment option.

Two Powerful Payment Methods

Bale In-Chat Wallet & Invoice Payment

Customers can receive their WooCommerce order as a payment invoice directly inside their Bale conversation.

The plugin communicates with Bale's Bot API and sends a native payment invoice without redirecting the customer to an external banking page.

After successful payment, Bale sends the payment result to the store through a secure webhook and the WooCommerce order can be completed automatically.

The system also validates:

• Payment amount
• Currency
• WooCommerce order
• Customer identity
• Bale chat identity
• Invoice expiration
• Duplicate payments
• Payment status

This multi-stage validation helps protect transactions against manipulated requests, expired invoices, duplicate charges, and replay attempts.

Card-to-Card Bank Transfer

AryaPortal BalePay also includes a complete card-to-card payment workflow.

Store owners can configure multiple destination bank cards and display them at checkout. Customers select a card, transfer the required amount, and upload their payment receipt directly from the order confirmation page.

Supported receipt formats include:

• JPG
• PNG
• WEBP
• PDF

Orders are automatically placed On Hold until an administrator reviews the submitted receipt. Administrators can approve or reject receipts directly from the transaction dashboard.

Bale Account Linking

To improve payment identity verification, customers can connect their Bale account to their WooCommerce account.

The plugin adds a dedicated Connect BalePay section to the WooCommerce My Account page.

A secure, temporary linking code is generated and the customer can open the store's Bale bot using a dedicated deep link. Once the code is verified, the customer's Bale chat ID is securely associated with their WordPress account.

A shortcode is also included:

[aryaportal_balepay_connect]

This allows store owners to place the Bale connection interface anywhere on their website, including custom account pages and landing pages.

Automatic Order Management

AryaPortal BalePay is designed to minimize manual payment management.

The plugin can automatically:

• Remember the selected payment method
• Apply payment-method-specific discounts
• Expire unpaid Bale invoices
• Expire card-to-card payment windows
• Cancel expired unpaid orders
• Record important payment events
• Track receipt submissions
• Record validation errors
• Maintain a complete payment audit trail

Payment expiration is handled by a scheduled WordPress Cron task, helping keep the WooCommerce order list clean and organized.

Secure Bale Webhook & REST API

Security is a core part of AryaPortal BalePay.

The plugin provides a dedicated WordPress REST API endpoint for receiving real-time Bale events.

The webhook is protected by a randomly generated 64-character secret token and uses timing-safe verification.

The system handles:

1. Bale account linking
2. Pre-checkout payment validation
3. Successful payment confirmation
4. Duplicate-payment protection
5. Automatic WooCommerce order completion

A Register Webhook button allows administrators to register the webhook automatically, while the Test Connection feature can verify the Bale bot and webhook configuration from the admin panel.

Powerful WooCommerce Admin Dashboard

AryaPortal BalePay includes a dedicated admin dashboard designed for easy payment management.

The dashboard includes:

Dashboard

View the current gateway status and recent payment activity.

Bank Cards Manager

Add, edit, enable, disable, and delete multiple bank cards for card-to-card payments.

Transactions Manager

View wallet and card transactions with statuses such as:

• Sent
• Paid
• Pending Review
• Rejected
• Expired

Administrators can also review receipts and manage payment actions directly from the dashboard.

Transaction Export

Export transaction records for accounting, financial reconciliation, or internal reporting.

Centralized Settings

Configure the main gateway settings from one place, including:

• Bale bot username
• Bot token
• Payment provider token
• Webhook secret
• Payment deadline
• Receipt review deadline
• Payment discounts
• Notification templates
• Receipt upload limits
• Admin dashboard accent color

The notification system also supports dynamic placeholders such as {order_id}, {total}, {customer}, and {note}.

Security-Focused Payment Architecture

AryaPortal BalePay is built with multiple security layers.

Sensitive credentials such as the Bale bot token, payment provider token, and webhook secret are encrypted before being stored in the database.

The plugin also uses:

• WordPress nonce verification
• Capability checks
• MIME and extension validation
• Secure Media Library handling
• Timing-safe token comparisons
• Payment amount validation
• Currency validation
• Customer identity verification
• Bale chat identity verification
• Payment expiration validation

If an incoming payment does not pass the required validation checks, it can be routed for manual review rather than being silently accepted.

Deep WooCommerce Integration

AryaPortal BalePay is built for modern WooCommerce installations.

The plugin supports:

• WooCommerce High-Performance Order Storage (HPOS)
• WooCommerce Cart & Checkout Blocks
• Classic WooCommerce Checkout
• Native WooCommerce Blocks payment integrations
• Automatic order notes
• WooCommerce order status transitions
• Payment-specific thank-you page content
• Payment-specific order emails

Each payment method also has its own availability rules, helping prevent incomplete or incorrectly configured payment methods from appearing to customers.

Built for the Iranian Market

AryaPortal BalePay is specifically designed for Iranian WooCommerce stores.

The payment methods support:

• IRR
• IRT
• TOMAN

The customer-facing and administrative interface is Persian and RTL-ready by default, including payment messages, error messages, dashboard interfaces, and Bale bot responses.

The plugin also uses standard WordPress translation functions, allowing further localization when required.

Why Choose AryaPortal BalePay?

AryaPortal BalePay combines two payment workflows in a single WooCommerce gateway:

Automated Bale Payment + Manual Card-to-Card Payment

With its secure webhook architecture, Bale account linking, automatic order management, transaction dashboard, receipt verification, WooCommerce Blocks compatibility, HPOS support, Persian RTL interface, and configurable notifications, it provides a comprehensive payment solution for Iranian WooCommerce stores.

Key Features

• Bale in-chat wallet/invoice payments
• Card-to-card bank transfer
• Payment receipt upload
• Manual receipt approval/rejection
• Automatic Bale account linking
• Secure webhook integration
• Payment identity validation
• Duplicate payment protection
• Automatic invoice expiration
• Automatic order cancellation
• Payment-method discounts
• Transaction management
• CSV transaction export
• Encrypted credentials
• Secure file upload validation
• WooCommerce HPOS compatibility
• WooCommerce Cart & Checkout Blocks support
• Classic checkout support
• Persian RTL interface
• Custom notification templates
• Configurable uninstall data management