MPA3:Admin area/Sites & tools/Upgrade Plus Settings

From Mansion Productions WIKI
Jump to: navigation, search

Upgrade Plus Settings

Sites upgrade-plus.jpg

  • Title - Title of the upgrade product (for your personal use).
  • Passwords file - Passwords file to be used for members after they upgrade. The member will still remain in the old password file after the upgrade.
  • Passwords management URL - The URL of the password management script. You need 1 script per server. This is the same adp.cgi/adp.php script that mpa3 uses to manage the members.
  • Success URL - On successful upgrade the member will be redirected to this URL.
  • Denial URL - On failure member will be redirected to this URL.
  • Upgrade trial price - The price for member that will upgrade from trial to monthly membership. In most of the cases this is the recurring price of the product.
  • Upgrade recurring price - The price for recurring members that will upgrade.
  • Upgrade recurring days - The recurring days of the upgrade.
  • Epoch ti_code - It is provided by epoch for your custom per site upgrade pages.


Setting up membership upgrades

1. Go to mpa3admin>sites>upgrade plus settings, and enter these parameters: Title, Passwords file, Passwords management URL, Success URL, Denial URL, Upgrade trial price, Upgrade recurring price and Upgrade recurring days.

2. Once you save the setting, a table with the already saved settings will appear. Get the id of the setting you want to use, and save it for later use. We'll call this id the upgrade_id.

3. Set in your members area a link for the members to use like this: http://mpa3url.com/upgrade_plus/index.php?username=usernamehere&upgrade_id=X Where username is the member username and upgrade_id is the id of the upgrade settings that you set in step 2 above. To populate the username you can use the php variable $PHP_AUTH_USER (or the according equivalent if you are using other script language). So the link will look similar to this: http://mpa3url.com/upgrade_plus/index.php?username=john&upgrade_id=1 The link may offer upgrading from trial to full membership, or additional membership for another site. You need to talk with the processors to set your account what will happen in case of upgrade. CCBill set on their end how the upgrade works. See the CCBill_Subscription_Upgrade_Users_Guide.pdf (provided by CCBill) document for additional instructions.

4. Make sure processors are posting the result of the upgrade to: http://mpa3url.com/signup/ccbill.php http://mpa3url.com/signup/epoch.php etc... This is the regular mpa3 postback url for the processors, so it is probably already set.

5. If you are setting CCBill, make sure to give your mpa3 server ip to CCBill, so they can allow it for Backend HTTPS Post.


How it all works

For CCBill

1. First you need to define the upgrade parameters here: http://mpa3url.com/admin/admin.php?action=sites_default#t5Tab You need to specify the upgrade trial/rebill price, password management url/file, etc. When you set this, the data will be saved into the db, and upgrade id wil be generated.

2. When a member clicks on a upgrade link from your members area. The link redirects him to: http://mpa3url.com/upgrade_plus/index.php?username=$PHP_AUTH_USER&upgrade_id=X

3. The mpa3 script will see that the member is a ccbill member and will call ccbill in the background like this: https://bill.ccbill.com/jpost/upgradeSubscription.cgi?clientAccnum=$this->clientAccnum&clientSubacc=$this->clientSubacc&action=allowUpgrade&username=$username' This will open an upgrade window for the member.

4. Then mpa3 and will redirect him to https://bill.ccbill.com/jpost/upgradeSubscription.cgi where he can see a form describing for what and how much he'll be charged. and to enter his CC CVV2 code.

5. After submitting the form, he is upgraded, and ccbill sends a postback to mpa3 to notify us about the upgrade.


For Epoch, it is similar, with few exceptions.

1. Again you need to define the upgrade parameters here: http://mpa3url.com/admin/admin.php?action=sites_default#t5Tab You need to specify the Epoch ti_code, upgrade trial/rebill price, password management url/file, etc. When you set this, the data will be saved into the db, and upgrade id wil be generated. You can use the same setting for all processors, if the parameters match.

2. When a member clicks on a upgrade link from your members area. The link redirects him to: http://mpa3url.com/upgrade_plus/index.php?username=$PHP_AUTH_USER&upgrade_id=X

3. The mpa3 script will see that the member is a epoch and will redirect him to https://epoch.com/secure/memberupgrade.cgi?username=$username&upgrade_id=$member->subscription_id"."$ti_code&returnurl=$returnurl where he can see a form describing for what and how much he'll be charged. and to enter his CC CVV2 code.

4. After submitting the form, he is upgraded, and epoch sends a postback to mpa3 to notify us about the upgrade.

If you don't like the epoch customer upgrade form shown in #3, you can send them your own template by editing the html file in the UpgradePlus-Sample_Package.zip archive that you can request from them. There you'll need to enter the hidden form field named "returnurl" to your members area url (from where the member came), and the "pburl" hidden field to: http://mpa3url.com/signup/epoch.php

Personal tools
Namespaces

Variants
Actions
Products
Navigation
Toolbox