Note: You are currently viewing documentation for Moodle 2.9. Up-to-date documentation for the latest stable version of Moodle may be available here: Paypal enrolment.

Paypal enrolment: Difference between revisions

From MoodleDocs
(all currencies available)
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Enrolment}}
{{Enrolment}}
Location: PayPal edit settings link in ''Site administration > Plugins > Enrolments > Manage enrol plugins''
The PayPal enrolment plugin allows users to pay for courses and then be automatically enrolled.


The PayPal enrolment plugin allows you to set up paid courses. The plugin has to be enabled by the site administrator (see [[Enrolment_plugins|Enrolment plugins]])and then added to the course by an administrator or manager. You can then set an individual price for your course if needed.
==PayPal account creation==
 
# Go to https://www.paypal.com and create a Paypal account. Not required but recommended for selling: Upgrade your account to "Premier" status and get "Verified"
# Set the Encoding to UFT-8.  In Paypal, go to ''Profile > Profile & Settings > My Selling Preferences (from left menu) > Paypal button language encoding'' (at the bottom of the page under More Selling Preferences) and set your website's language (like select "Western European Languages (including English)" as it is the only English version).  Then click on the "More Options" button and set the Encoding to "UTF-8", select "Yes" to use the same encoding for data sent from Paypay to you, and save.
# Optionally setup IPN in Paypal to interact with Moodle.  Log into Paypal, go to "Profile > Instant Payment Notifications (IPN)”, click "Turn On IPN", click the "Edit settings" and enter a URL that references your IPN file in your Moodle installation (for example: http://<domain name>/moodle/enrol/paypal/ipn.php)
 
==Enabling PayPal enrolment==
 
An administrator can enable PayPal file enrolment as follows:
 
# ''Go to Site administration > Plugins > Enrolments > Manage enrol plugins'' and click the eye icon opposite PayPal. When enabled, it will no longer be greyed out. Manual enrolment must also be enabled, since the PayPal plugin requires it.
# Click the settings link, configure as required (see details of settings below), then click the 'Save changes' button.
 
* PayPal business email - This setting is case sensitive and must exactly match that in PayPal
* Default role assignment - This means the role that a new user will automatically be given in a course when they purchase access. Usually this would be "student" unless you have a special reason for choosing another role. As for other default settings, it may be overridden in individual courses.
 
Tip: If you wish to allow users to create their own accounts on your site then you need to set up [[Email-based_self-registration|Email based self registration]].


==Course settings for Paypal==
==Course settings for Paypal==
===Checking you have Paypal in your course===
===Checking you have Paypal in your course===
*In a course, go to Settings> Course administration>Users>Enrolment methods
*If you do not see PayPall, use the pull down menu "Add method" and select PayPal.


*Make sure PayPal has its "eye" opened:  
# In a course, go to ''Administration> Course administration > Users > Enrolment methods''
# If you do not see PayPal, use the pull down menu "Add method" and select PayPal.
# Make sure PayPal has its "eye" opened:  


[[File:Paypalenrolmentmethod.png]]
[[File:Paypalenrolmentmethod.png]]
Note: Make sure you don't  have [[Self enrolment]] enabled as this would allow users to access the course without paying. If you do need some users to self enrol for free, then add an enrolment key in the self enrolment settings.


===Setting a price for your course===
===Setting a price for your course===
*In Settings>Course Administration>Users>enrolment methods, click the edit/hand/pen icon to the right of the Paypal option.  
 
*Give a name to this enrolment method if you wish in "Custom Instance name". (You don't have to!)
# In ''Course Administration > Users > Enrolment methods'', click the edit/hand/pen icon to the right of the PayPal option.  
*Ensure that "allow Paypal enrolments" is set to "yes"
# Optional: Give a name to this enrolment method if you wish in "Custom Instance name"
*In "Enrol cost", type in the cost of your course and in "Currency" choose your currency.{{New features}}
# Ensure that "Allow PayPal enrolments" is set to "yes"
''Note that since Moodle 2.5 all Paypal supported currencies are available.''
# In "Enrol cost", type in the cost of your course and in "Currency" choose your currency.
*Usually you would leave the "Assign role" as "student" unless you have a very special reason for allowing your users to enrol as, say, editing teachers etc
# Usually you would leave the "Assign role" as "student" unless you have a very special reason for allowing your users to enrol as, say, editing teachers etc
*Choose an enrolmet period and/or start/end dates if desired.
# Choose an enrolment period and/or start/end dates if desired.
*Click the "Save changes" button.
# Click the "Save changes" button.


[[File:Paypalcoursesettings.png]]
[[File:Paypalcoursesettings.png]]


===What the new user sees===
===What the new user sees===
*When a new user clicks on  your course link, having made a login to your Moodle, they will see the following screen, inviting them to go to PayPal to purchase access to your course:


[[File:Paypaluserview.png]]
When a new user clicks on your course link, they will see a message inviting them to go to PayPal to purchase access to the course. In the list of courses, PayPal courses have a dollar sign icon next to them.


==Admin settings==
{|
 
| [[File:Paypaluserview.png|frame|left|Message inviting user to pay via PayPal]]
#If you wish to allow users to make their own accounts on your site then set up [[Email-based_self-registration|Email based self registration]]
| [[File:Paypalicon.png|frame|left|PayPal course listed with dollar sign icon]]
#Go to ''Settings>Site Administration>Plugins>Enrolments>Manage enrol plugins'' and enable (open the "eye" of Paypal)
|}
#Click the blue Settings link to the right of the PayPal enrolment link. Here are the default settings and default settings for new instances in a course:
##Add the email of your Business PayPal account. The email settings are case sensitive and must exactly match that in PayPal.
##Choose whether to notify students/teachers/admin.
##Choose whether (or not) to allow the Paypal enrolment plugin by default in new courses
##Choose a default cost and currency. (This may  be overridden in individual courses)
##Choose a default role assignment. (This means the role that a new user will automatically be given in a course when they purchase access. Usually this would be "student" unless you have a special reason for choosing another role.) This may be overridden in individual courses.
##Choose the default enrolment period. This may be overridden in individual courses.
 
==What to set up in Paypal==
* Setup your PayPal account at paypal.com
# Create a Paypal account
# Not required but recommended for selling: Upgrade your account to "Premier" status and get "Verified"
# Set the Encoding to UFT-8.  In Paypal, go to "Profile > Language Encoding" (under the Selling Preferences column) and set your website's language (like select "Western European Languages (including English)" as it is the only English version).  Then click on the "More Options" button and set the Encoding to "UTF-8", select "Yes" to use the same encoding for data sent from Paypay to you, and save.
# Optionally setup IPN in Paypal to interact with Moodle.  Log into Paypal, go to "Profile > Instant Payment Notifications (IPN)”, click "Turn On IPN", click the "Edit settings" and enter a URL that references your IPN file in your Moodle installation (for example: http://<domain name>/moodle/enrol/paypal/ipn.php)
 
==What the user sees==
*If you have allowed users to create their own accounts then when they click to login, they will be presented with a screen'' Is this your first time here?'' It will give them instructions for making an account (which may be customised in the authentication common settings in ''Settings > Site administration > Plugins > Authentication > Manage authentication'') and once their account is confirmed via email they can click on a course which can be purchased and pay for it via Paypal. PayPal courses will have a dollar sign icon next to them:
 
[[File:Paypalicon.png]]
 
*Once payment is made both the user/student and the teacher/admin should have received emails from Paypal confirming the purchase.


==Changing the dollar symbol==
==Changing the dollar symbol==
The default currency symbol for Paypal is a dollar sign. If you are using GBP or Euros or another currency, you can change this by creating your own customised icon with your choice of currency. Make it 16x 16 pixels and call it ''icon.gif''  Upload your new icon via FTP to your  ''moodle directory>enrol>paypal>pix''. Your icon.gif will override the dollar sign. Make sure you refresh your page to be sure of the changes.
[[File:PaypalGBP.png|frame|PayPal course listed with GBP sign icon]]
 
The default currency symbol for PayPal is a dollar sign. If you are using GBP or Euros or another currency, you can change this by creating your own customised icon with your choice of currency. Make it 16x 16 pixels and call it ''icon.gif''  Upload your new icon via FTP to your  ''moodle directory>enrol>paypal>pix''. Your icon.gif will override the dollar sign. Make sure you refresh your page to be sure of the changes.
[[File:PaypalGBP.png]]


==Paypal capabilities==
==PayPal capabilities==


*[[Capabilities/enrol/paypal:config|Configure PayPal enrol instances]]
*[[Capabilities/enrol/paypal:config|Configure PayPal enrol instances]]
Line 71: Line 67:
[[de:Paypal-Einschreibung]]
[[de:Paypal-Einschreibung]]


== See also ==
*[http://moodle.org/mod/forum/discuss.php?d=171745#p977221 Testing the PayPal plugin in the PayPal Sandbox]


== See Also ==
[[es:Inscripción por Paypal]]
*[http://moodle.org/mod/forum/discuss.php?d=171745#p977221 Testing the PayPal plugin in the PayPal Sandbox]

Latest revision as of 10:53, 19 May 2016

The PayPal enrolment plugin allows users to pay for courses and then be automatically enrolled.

PayPal account creation

  1. Go to https://www.paypal.com and create a Paypal account. Not required but recommended for selling: Upgrade your account to "Premier" status and get "Verified"
  2. Set the Encoding to UFT-8. In Paypal, go to Profile > Profile & Settings > My Selling Preferences (from left menu) > Paypal button language encoding (at the bottom of the page under More Selling Preferences) and set your website's language (like select "Western European Languages (including English)" as it is the only English version). Then click on the "More Options" button and set the Encoding to "UTF-8", select "Yes" to use the same encoding for data sent from Paypay to you, and save.
  3. Optionally setup IPN in Paypal to interact with Moodle. Log into Paypal, go to "Profile > Instant Payment Notifications (IPN)”, click "Turn On IPN", click the "Edit settings" and enter a URL that references your IPN file in your Moodle installation (for example: http://<domain name>/moodle/enrol/paypal/ipn.php)

Enabling PayPal enrolment

An administrator can enable PayPal file enrolment as follows:

  1. Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite PayPal. When enabled, it will no longer be greyed out. Manual enrolment must also be enabled, since the PayPal plugin requires it.
  2. Click the settings link, configure as required (see details of settings below), then click the 'Save changes' button.
  • PayPal business email - This setting is case sensitive and must exactly match that in PayPal
  • Default role assignment - This means the role that a new user will automatically be given in a course when they purchase access. Usually this would be "student" unless you have a special reason for choosing another role. As for other default settings, it may be overridden in individual courses.

Tip: If you wish to allow users to create their own accounts on your site then you need to set up Email based self registration.

Course settings for Paypal

Checking you have Paypal in your course

  1. In a course, go to Administration> Course administration > Users > Enrolment methods
  2. If you do not see PayPal, use the pull down menu "Add method" and select PayPal.
  3. Make sure PayPal has its "eye" opened:

Paypalenrolmentmethod.png

Note: Make sure you don't have Self enrolment enabled as this would allow users to access the course without paying. If you do need some users to self enrol for free, then add an enrolment key in the self enrolment settings.

Setting a price for your course

  1. In Course Administration > Users > Enrolment methods, click the edit/hand/pen icon to the right of the PayPal option.
  2. Optional: Give a name to this enrolment method if you wish in "Custom Instance name"
  3. Ensure that "Allow PayPal enrolments" is set to "yes"
  4. In "Enrol cost", type in the cost of your course and in "Currency" choose your currency.
  5. Usually you would leave the "Assign role" as "student" unless you have a very special reason for allowing your users to enrol as, say, editing teachers etc
  6. Choose an enrolment period and/or start/end dates if desired.
  7. Click the "Save changes" button.

Paypalcoursesettings.png

What the new user sees

When a new user clicks on your course link, they will see a message inviting them to go to PayPal to purchase access to the course. In the list of courses, PayPal courses have a dollar sign icon next to them.

Message inviting user to pay via PayPal
PayPal course listed with dollar sign icon

Changing the dollar symbol

PayPal course listed with GBP sign icon

The default currency symbol for PayPal is a dollar sign. If you are using GBP or Euros or another currency, you can change this by creating your own customised icon with your choice of currency. Make it 16x 16 pixels and call it icon.gif Upload your new icon via FTP to your moodle directory>enrol>paypal>pix. Your icon.gif will override the dollar sign. Make sure you refresh your page to be sure of the changes.

PayPal capabilities

See also