Get started Get started

Howdy!

Bank Mellat (BehPardakht Mellat) Payment Gateway for Botble CMS

$ 19.00
$ 29.00 Save 34%
  • Lifetime access to the file
  • 6 months of completely free support
  • Quality and authenticity guaranteed
  • Money-back guarantee

Secure and complete integration of your Botble-powered store with the Bank Mellat online payment gateway (BehPardakht Mellat) — easy installation, simple configuration, with support for both Toman and Iranian Rial.

Read more

Bank Mellat (BehPardakht Mellat) Payment Gateway Plugin for Botble CMS

With the Bank Mellat Payment Gateway Plugin, your Botble CMS-powered store or website can accept online payments directly through BehPardakht Mellat, the official online payment gateway provided by Bank Mellat for its internet merchants.

This plugin is built using Bank Mellat's official and secure SOAP web service and automatically handles the complete payment process — from transaction creation to Verification (Verify) and Settlement (Settle) — without requiring complicated configuration.

Why Choose This Plugin?

Accurate Implementation Based on Bank Mellat's Official Documentation

The three required stages of the payment process — Payment Request, Transaction Verification, and Transaction Settlement — are fully implemented and executed sequentially, helping prevent incomplete transactions or situations where an amount is deducted from the customer's account without a properly completed payment.

Fully Compatible with Botble's Payment Architecture

The plugin follows the standard payment architecture used by Botble CMS, ensuring seamless integration with the platform's existing payment system.

Toman and Iranian Rial Support

Because the Bank Mellat payment gateway accepts amounts only in Iranian Rial, the plugin allows you to specify whether your store uses Toman or Rial as its currency. The required conversion is performed automatically before the payment request is sent to the bank.

Clear and User-Friendly Error Messages

Bank Mellat provides numerous transaction error codes, including invalid card, insufficient balance, incorrect PIN, user cancellation, and many other cases. The plugin translates these error codes into clear and understandable messages so both customers and administrators can easily understand why a transaction failed.

Payment Details in the Admin Panel

For each successful transaction, important payment information such as the tracking number, reference number (RefId), last four digits of the card, and exact payment time can be viewed from the order details in the administration panel.

Quick Installation and Setup

Getting started takes only a few minutes. Simply enter the Terminal ID, Web Service Username, and Web Service Password provided by Bank Mellat.

Technical Features

FeatureDescription
Connection TypeOfficial Bank Mellat SOAP Web Service (bpm.shaparak.ir)
Transaction FlowbpPayRequest → bpVerifyRequest → bpSettleRequest
CurrencyToman or Iranian Rial with configurable automatic conversion
Transaction DetailsTracking Number, Reference ID (RefId), Card Number, Payment Time
User Interface LanguagePersian and English (Bilingual)
Country RestrictionAbility to restrict this payment method to specific countries

Requirements

  • The Payment module must be installed and enabled in Botble CMS.
  • An active internet merchant agreement with Bank Mellat and valid Terminal ID, Web Service Username, and Web Service Password are required.
  • The PHP SOAP extension must be enabled on your hosting server. This is available on most standard Linux hosting environments.

Installation & Setup

  1. Upload the plugin files to the following directory in your Botble CMS installation:platform/plugins/mellat
  2. From the administration panel, go to Plugins and activate Mellat Payment Gateway.
  3. Enter and activate the license key you received on the Plugin Licenses page.
  4. Navigate to Settings > Payment Methods and open the Mellat payment method.
  5. Enter the Terminal ID, Web Service Username, and Web Service Password provided by Bank Mellat.
  6. Select the gateway currency (Toman or Iranian Rial) according to your store's currency settings.
  7. Enable this payment method and save the configuration.

The Bank Mellat payment option will now be available to customers on your store's checkout page.

Frequently Asked Questions

  • Does this plugin support Sandbox/Test Mode?

Bank Mellat does not provide a publicly available official sandbox environment like some other payment gateways. The connection therefore needs to be configured using valid and active terminal credentials.

  • Do payment amounts have to be entered in Iranian Rial?

No. It is not necessary to manually enter all amounts in Rial. Simply specify in the plugin settings whether your store uses Toman or Iranian Rial, and the required conversion will be performed automatically.

  • What happens if the connection is interrupted between transaction verification and settlement?

The plugin executes the verification and settlement stages sequentially according to Bank Mellat's official payment protocol. If an error occurs during either stage, the transaction is reported as unsuccessful and the corresponding error message is displayed, allowing the customer to try the payment again.

  • Can I use this plugin alongside other payment gateways?

Yes. The plugin operates independently and can be enabled alongside any other payment gateways installed on your Botble CMS website.

Version History

Version 1.0.0

  • Initial release
  • Complete implementation of the Bank Mellat payment flow: Payment Request, Verification, and Settlement
  • Automatic Toman-to-Rial conversion
  • Transaction details displayed in the administration panel
  • Full Persian and English language support

Support

Technical support for this product is provided by AryaPortal.

For obtaining a license, installation assistance, configuration guidance, or reporting technical issues, please contact the AryaPortal support team.

Leave a comment

Product Details
Plugin Details
  • Software Framework Laravel
  • Plugin Version 1.0.0
  • Compatible PHP Version 8.2 to 8.5
  • Botble Version 7.3.0 or higher
Share: