MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Requirements

• This plugin requires Moodle 4.2.0+

Warning

• This plugin is 100% open source and has NOT been tested in Moodle Workplace, Totara, or any other proprietary software system. As long as the latter do not reward plugin developers, you can use this plugin only in 100% open source environments.

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Requirements

• This plugin requires Moodle 4.2.0+

Warning

• This plugin is 100% open source and has NOT been tested in Moodle Workplace, Totara, or any other proprietary software system. As long as the latter do not reward plugin developers, you can use this plugin only in 100% open source environments.

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Requirements

• This plugin requires Moodle 4.2.0+

Warning

• This plugin is 100% open source and has NOT been tested in Moodle Workplace, Totara, or any other proprietary software system. As long as the latter do not reward plugin developers, you can use this plugin only in 100% open source environments.

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Requirements

• This plugin requires Moodle 4.2.0+

Warning

• This plugin is 100% open source and has NOT been tested in Moodle Workplace, Totara, or any other proprietary software system. As long as the latter do not reward plugin developers, you can use this plugin only in 100% open source environments.

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Dependencies

• MOODLE_401_STABLE needs the Amazon's SDK for PHP plugin.


• MOODLE_402_STABLE+ relies on Guzzle (already a part of Moodle).

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Dependencies

• MOODLE_401_STABLE needs the Amazon's SDK for PHP plugin.


• MOODLE_402_STABLE+ relies on Guzzle (already a part of Moodle).

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Dependencies

• MOODLE_401_STABLE needs the Amazon's SDK for PHP plugin.


• MOODLE_402_STABLE+ relies on Guzzle (already a part of Moodle).

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Dependencies

• MOODLE_401_STABLE needs the Amazon's SDK for PHP plugin.


• MOODLE_402_STABLE+ relies on Guzzle (already a part of Moodle).

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Dependencies

• MOODLE_401_STABLE needs the Amazon's SDK for PHP plugin.


• MOODLE_402_STABLE+ relies on Guzzle (already a part of Moodle).

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

MTN

This plugin was developed thanks to funding from Medical Access Uganda (https://e-learning.medical-access.org)

The plugin allows a site to connect to MTN Africa to process payments.

Currently this plugin supports payment on following currencies:

| Country | Country Code | Currency | Currency Code |
| :---- | :----: | :---- | :----: |
| Benin | BJ | West African CFA franc | XOF |
| Cameroon | CM | CFA franc BEAC | XAF |
| Chad | TD | CFA franc BEAC | XAF |
| Congo-Brazzaville | CG | CFA franc BCEA | XAF |
| DR Congo | CD | Congolese franc | CDF |
| Ghana | GH | Ghanaian New Cedi | GHS |
| Guinea | GN | Guinean franc | GNF |
| Ivory Coast | CI | West African CFA franc | XOF |
| Liberia | LR | Liberian Dollar | LRD |
| Niger | NE | CFA franc BCEAO | XOF |
| Rwanda | RW | Rwandan Franc | RWF |
| South Africa | ZA | South African Rand | ZAR |
| Uganda | UG | Ugandan shilling | UGX |
| Zambia | ZM | Zambian kwacha | ZMW |
| Testing | sandbox | Euro | EUR |

Rates of Using MoMo Pay

MoMoPay service is free for all customers.
Formal merchants will be charged 2% of the payment received.
Informal merchants will be charged 1% of the payment received.

Setup MTN account

To set up access within Moodle you will need to:

• Register a new application (MTN Africa have their own docs on this.)


• Enable the Collections service so you can do remote collection of bills, fees or taxes.


• Create a new application where you can configure the callback url. The URL is in the format "https://example.com/payment/gateway/mtnafrica/callback.php".


• Visit Go live, enable the countries you want to work in, add KYC information, and you can use the plugin live.


• Make a phone call to your local MTN representative so your submitted resquest is accepted, yes, somebody at MTN Africa needs to turn a switch before your changes take effect.


• For every change, callback url, enable extra APIs, ... see previous line.

Install

You can install this plugin from the plugin directory or get the latest version on GitHub.

git clone https://github.com/iplusacademy/moodle-paygw_mtnafrica.git payment/gateway/mtnafrica

Dependencies

• MOODLE_401_STABLE needs the Amazon's SDK for PHP plugin.


• MOODLE_402_STABLE+ relies on Guzzle (already a part of Moodle).

Configure Moodle

• Go to site administration / Plugins / Manage payment gateways and enable the MTN payment gateway.


• Go to site administration / Payments / Payment accounts


• Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.


• On the Payment accounts page, click the payment gateway link to configure mtn.


• In the configuration page,
  
  
  
  • Enter your primary key from the collection service you have created in the MTN developer centre
  
  
  • Enter your secondary key from the collection service you have created in the MTN developer centre
  
  
  
  

Add Enrolment on payment.

• Go to Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Enrolment on payment.


• Click the settings link, configure as required then click the 'Save changes' button.


• Go to the course you wish to enable payment for, and add the 'Enrolment on payment' enrolment method to the course.


• Select a payment account, amend the enrolment fee as necessary then click the button 'Add method'.

see also:

moodledocs: Payment Gateways

moodledocs: Enrolment on Payment

Theme support

This plugin is developed and tested on Moodle Core's Boost theme and Boost child themes, including Moodle Core's Classic theme.

Database support

This plugin is developed and tested using

• MYSQL


• MariaDB


• PostgreSQL

Testing

The easiest way to test this plugin is to configure your sandbox environment with the keys provided from MTN.
When you create a course and add a enrolment on fee with the cost of 40 EUR (the sandbox only accepts EURO).
Next create a user with '46733123454' as telephone number and log in as this user. When asked for a payment,
you will be able to see the payment process completely, and after some waiting be automatically enrolled in the course.

This plugin can also be tested in PHPUnit and Behat, but you need to add your login - secret - secret1 keys as an environment variable.

* env login=???? secret=???? secret1=???? vendor/bin/phpunit --coverage-text payment/gateway/airtelafrica/

* env login=???? secret=???? secret1=???? vendor/bin/behat --tags='paygw_airtelafrica'

Or you can use secrets in Github actions:

* gh secret set login -b"?????"

* gh secret set secret -b"?????"

* gh secret set secret1 -b"?????"

Plugin repositories

This plugin will be published and regularly updated on Github

Bug and problem reports / Support requests

This plugin is carefully developed and only thoroughly tested in Uganda, but bugs and problems can always appear.
Please report bugs and problems on Github
We will do our best to solve your problems, but please note that we can't provide per-case support.
Please contact you MTN Africa representative in case you get invalid transactionids or timeouts.

Feature proposals

• Please issue feature proposals on Github


• Please create pull requests on Github


• We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.

Status

License

2023 Medical Access Uganda

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.