Magento 2 Reference

Installation

Supported versions: Magento 2.3, 2.4

  1. Go to Integration (opens in a new tab) at Donmo Dashboard

  2. Generate API keys, activate integration, set up currency and roundup rule that you prefer (default - 10)

  3. Install Magento module with Composer (opens in a new tab):

    composer require donmo-roundup/module-donations

  4. Execute the following Magento CLI commands:

    php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Settings

  1. Go to Admin -> Stores -> Configuration -> Sales -> Donmo Roundup

  2. Fill all the fields, including the integration mode (test or live) and API keys

  3. After any change of configurations, it's recommended to clean the cache with command
    php bin/magento cache:clean

Check

  1. Make sure the integration mode is set as test, while Magento mode - as developer

  2. Put the product inside the cart and go to the payment page (or to the cart page)

  3. The integration window should appear at the bottom

How it works

  1. The customer places an order and rounds up the total amount.

  2. The rounded donation is stored in the Magento database in a separate table donmo_donations.

  3. At the end of each month, the integration cron script sends all donations through the Donmo API.

  4. At the beginning of the new month, an invoice and report are generated with a request to pay the corresponding amount of donations through the Donmo account.

  5. The collected funds are distributed equally between the three funds, specifically "Come Back Alive Foundation (opens in a new tab), United24 (opens in a new tab) та Serhiy Prytula Charity Foundation (opens in a new tab)