Bale Pay | Iranian Messenger Payment Gateway for Botble CMS

Bale Pay by AryaPortal | Native Bale Messenger Payment Gateway for Botble CMS

Bale Pay is a purpose-built payment gateway for Botble CMS, connecting your online store directly to Iran's popular Bale messenger ecosystem. It gives customers two fast, familiar ways to pay — direct in-chat wallet payment through Bale and card-to-card bank transfer with receipt review — all delivered through Botble's official plugin architecture, with zero manual theme edits required.

Why Bale Pay?

Iranian online stores are constantly looking for ways to cut bank gateway fees, reduce checkout friction, and boost conversion rates. Bale Pay taps directly into the Bale messenger infrastructure so customers can receive and pay an invoice without ever leaving the app they already trust — or, where a bank PSP isn't available, fall back to a fully managed card-to-card flow with a professional receipt-review workflow.

Full Feature Set

1. Direct Bale Wallet Payment

• Automatically sends a payment invoice straight into the store's Bale bot chat the moment an order is placed.
• One-time account linking flow for customers, with a quick-connect button or a manual in-app command.
• Real-time payment confirmation via a dedicated Bale webhook — no manual review, no delay in order confirmation.
• Configurable invoice image: the plugin's stable default banner, the order's first product image, or no image at all.
• Adjustable payment deadline (in minutes), with automatic hourly expiration of unpaid invoices via Laravel's task scheduler.
• Smart Toman/Rial currency handling with built-in warnings for misconfigured currency rates.

2. Card-to-Card Payment with Receipt Review

• Manage multiple destination bank cards, with active/inactive toggles and custom display order.
• Shows the exact order amount and card number to the customer at checkout.
• Customers upload their receipt image directly from the thank-you page or order tracking page.
• Admin review panel to approve or reject each receipt, with an optional note.

3. A Complete, Professional Admin Dashboard

Bale Pay adds a full, self-contained control center to the Botble admin panel, including:

• Dashboard: live stats — today's transactions, amount collected, pending reviews, linked users, and active cards.
• Gateways: full Bale bot configuration (bot token, provider token), invoice currency, and invoice image settings.
• Cards: complete destination-card management.
• Templates: customizable outgoing message templates.
• Bale Connections / Linked Users: view and manage customers who've linked their Bale account.
• Transactions & Logs: full transaction history with export, plus a technical event log for fast troubleshooting.
• Appearance: customize how payment methods are presented on the storefront.

4. Deep, Native Botble Integration

• Registers as an official payment method inside Botble's core Payment system, alongside your bank gateways.
• Automatically surfaces payment status (invoice pending / receipt required / rejected) on the order thank-you page and the customer's order-tracking page, using Botble's official hook points — no theme file editing needed.
• Fully compatible with Botble's Ecommerce module and admin permission system.

5. Security & Reliability

• Sensitive data (tokens) encrypted through Botble's native Settings system.
• Multi-layer validation on every payment event — amount matching, currency matching, order ownership, and invoice ownership — to prevent fraud or spoofed transactions.
• Full event logging (invoice sent, payment confirmed, expiration, connection errors) for complete transparency and easy debugging.

Who It's For

Botble-powered online stores looking to lower transaction fees, reach customers directly on Bale, or add a reliable alternative/backup payment method alongside their existing bank gateways.