WebMoneyMerchant payments for Laravel

2 2021-06-06 11:00 UTC

This package is auto-updated.

Last update: 2024-05-06 17:29:02 UTC


Latest Stable Version Build Status SensioLabsInsight Quality Score Total Downloads License

Accept payments via WebMoney Merchant ( using this Laravel framework package (Laravel).

  • receive payments, adding just the two callbacks
  • receive payment notifications via your email or Slack

You can accept payments with WebMoney Merchant via WebMoney, credit cards etc.


You can install the package through Composer:

composer require ashikkaiser/laravel-webmoney-merchant

Add the service provider to the providers array in config/app.php:

'providers' => [


Add the WebMoneyMerchant facade to your facades array:

    'WebMoneyMerchant' => ActionM\WebMoneyMerchant\Facades\WebMoneyMerchant::class,

Publish the configuration file and views

php artisan vendor:publish --provider="ActionM\WebMoneyMerchant\WebMoneyMerchantServiceProvider" 

Publish only the configuration file

php artisan vendor:publish --provider="ActionM\WebMoneyMerchant\WebMoneyMerchantServiceProvider" --tag=config 

Publish only the views

php artisan vendor:publish --provider="ActionM\WebMoneyMerchant\WebMoneyMerchantServiceProvider" --tag=views 


Once you have published the configuration files, please edit the config file in config/webmoney-merchant.php.

  • Create an account on

  • Set your project settings:

    • Merchant name;
    • Secret Key;
    • Secret Key X20;
    • Result URL;
    • Control sign forming method = SHA256;
    • Necessarily require signature payment form = ON;
    • Process payments with unique only lmi_payment_no = ON;
  • After the configuration has been published, edit config/webmoney-merchant.php

  • Copy the Secret Key X20 and Secret Key params and paste into config/webmoney-merchant.php

  • Set the callback static function for searchOrderFilter and paidOrderFilter

  • Set notification channels (email and/or Slack) and Slack webhook_url


  1. Generate an HTML payment form with enabled payment methods:
$payment_amount = Order amount 

$payment_no = Unique order number in your project, numbers only from 1 to 2147483647

$item_name = Name of your order item, only latin characters.
WebMoneyMerchant::generatePaymentForm($payment_amount, $payment_no, $item_name);

Customize the HTML payment form in the published view:


  1. Process the request from WebMoneyMerchant:
WebMoneyMerchant::payOrderFromGate(Request $request)


You must define callbacks in config/webmoney-merchant.php to search the order and save the paid order.

 'searchOrderFilter' => null  // ExampleController:searchOrderFilter($request)
 'paidOrderFilter' => null  // ExampleController::paidOrderFilter($request,$order)


The process scheme:

  1. The request comes from GET to check if your website is available.
  2. The request comes from POST (with params).
  3. The functionExampleController@payOrderFromGate runs the validation process (auto-validation request params).
  4. The static function searchOrderFilter will be called (see config/webmoney-merchant.php searchOrderFilter) to search the order by the unique id.
  5. If the current order status is NOT paid in your database, the static function paidOrderFilter will be called (see config/webmoney-merchant.php paidOrderFilter).

Add the route to routes/web.php:

Route::post('/webmoney/result', 'ExampleController@payOrderFromGate');
Route::get('/webmoney/result',  'ExampleController@payOrderFromGateOK');

Note: don't forget to save your full route url (e.g. ) for your project on

Create the following controller: /app/Http/Controllers/ExampleController.php:

class ExampleController extends Controller

     * Search the order if the request from WebMoney Merchant is received.
     * Return the order with required details for the webmoney request verification.
     * @param Request $request
     * @param $order_id
     * @return mixed
    public static function searchOrderFilter(Request $request, $order_id) {

        // If the order with the unique order ID exists in the database
        $order = Order::where('unique_id', $order_id)->first();

        if ($order) {
            $order['WEBMONEY_orderSum'] = $order->amount; // from your database

            // if the current_order is already paid in your database, return strict "paid"; 
            // if not, return something else
            $order['WEBMONEY_orderStatus'] = $order->order_status; // from your database
            return $order;

        return false;

     * When the payment of the order is received from WebMoney Merchant, you can process the paid order.
     * !Important: don't forget to set the order status as "paid" in your database.
     * @param Request $request
     * @param $order
     * @return bool
    public static function paidOrderFilter(Request $request, $order)
        // Your code should be here:

        // Return TRUE if the order is saved as "paid" in the database or FALSE if some error occurs.
        // If you return FALSE, then you can repeat the failed paid requests on the WebMoney Merchant website manually.
        return true;

     * Process the request from the WebMoney Merchant route.
     * searchOrderFilter is called to search the order.
     * If the order is paid for the first time, paidOrderFilter is called to set the order status.
     * If searchOrderFilter returns the "paid" order status, then paidOrderFilter will not be called.
     * @param Request $request
     * @return mixed
    public function payOrderFromGate(Request $request)
        return WebMoneyMerchant::payOrderFromGate($request);
    * Returns the service status for WebMoney Merchant request
    public function payOrderFromGateOK()
        return "YES";


Please see CHANGELOG for more information on what has changed recently.


$ composer test


Please see CONTRIBUTING for details.


If you discover any security related issues, please send me an email at instead of using the issue tracker.



The MIT License (MIT). Please see License File for more information.