Preparing SellerDeck for the Rebranding of PROTX to Sage Pay

[KB]

If you are using SellerDeck v9.0.4, v9.0.5 or v10.0.0 onwards you do not need to make any changes with regards to the rebranding of PROTX to Sage Pay as the updated URL’s are included in these releases.

If you are not using one of the versions listed above, for example SellerDeck v7.0.7 or v8.5.3, please follow the instructions below to update the URL’s as required by Sage Pay:

1. Close SellerDeck.
2. Open Notepad – if you are using Windows Vista, you should right click on Notepad in the Windows Start menu and select ‘Run as Administrator’.
3. Browse with Notepad to your SellerDeck installation, by default this is ‘C:\Program Files\Actinic vX*’.
4. Browse to ‘OCCUpgrade’ and open a file called ‘OCCUpgrade.ini’
   
   Note: It is strongly recommended that you make a backup of ‘OCCUpgrade.ini’ before making any changes.
   
   
5. At the top of the file, you will see:
   
   [Version]
   Number=1500
   
   Note: the number will not necessarily be 1500.
   
   
6. Increment the number by 1, e.g. 1500 becomes 1501
7. Search for the word ‘PROTX’, you will see
   
   PROTX=22
   
   Change this to be
   
   Sage Pay=22
   
   
8. Search for the word ‘PROTX’ again, you will see:
   
   ProviderName='PROTX'
   
   Change this to be
   
   ProviderName='Sage Pay'
   
   
9. Look down a few lines from where you have just made the change, you will see:
   
   ProviderURL='https://ukvps.protx.com/vspgateway/service/'
   
   Change this to be:
   
   ProviderURL='https://live.sagepay.com/gateway/service/'
   
   
10. Look down 3 more lines, you will see:
    
    DBProviderURL='https://ukvpstest.protx.com/vspgateway/service/'
    
    Change this to be:
    
    DBProviderURL='https://test.sagepay.com/gateway/service/'
    
    Please Note: If you are using version 7 or 8 you will also need to make the following changes, both: -
    
    RemoteProcessScript='submit.asp'
    
    and
    
    DBRemoteProcessScript='submit.asp'
    
    Need to be changed to read: -
    
    RemoteProcessScript='vspform-register.vsp'
    
    and
    
    DBRemoteProcessScript='vspform-register.vsp'
    
    
11. Save the file and close Notepad.
12. Open Notepad again, if you are using Vista you should run in Administrator mode.
13. Browse to ‘C:\Program Files\Actinic vX\OCCUpgrade\CommonOCC’ using Notepad and open ‘Act_OCCPROTXTemplate.html’
    
    Note: It is strongly recommended you backup this file before starting work. Also note that if you have multiple sites, and have customised the PROTX bounce page, you should make a copy of them, they can be found, by default in ‘My Documents\Actinic vX\Sites\<SiteName>\CommonOCC\ Act_OCCPROTXTemplate.html’
    
    
14. Locate the line that says
    
    <BR>You will now be automatically transferred to the Protx VSP secure server
    
    Change it to read;
    
    <BR>You will now be automatically transferred to the Sage Pay VSP secure server
    
    
15. Save the file
16. Open the file 'OCCPROTXScriptTemplate.pl' and search for: -
    
    my $sPROTXURL = '';
    
    and ensure that the URLs in the code below this are: -
    
    if ($bTestMode) {
    # $sPROTXURL = "http://localhost/";
    $sPROTXURL = "https://test.sagepay.com/";
    } else {
    # $sPROTXURL = "http://localhost/";
    $sPROTXURL = "https://live.sagepay.com/";
    }
    
    and close Notepad.
    
    NOTE: $sPROTXURL is used for v7 and v8, from v9 onwards this is replaced by $sSagePayURL
    
    
17. Open SellerDeck, you will notice that is performs an upgrade on the Payment Service Providers, this is fine.
18. Upload your site, and test you can place an order using Sage Pay online.

If it does not work, close SellerDeck restore your default ‘OCCUpgrade.ini’, and increment the number by 2, and also restore your ‘Act_OCCPROTXTemplate.html’, restart SellerDeck and upload the site.

Try making all the changes detailed in the article again.

* 'X' in the file paths above denote the version number of the software that you are using.

PLEASE NOTE: Versions earlier than v9 The original instructions from Protx/Sage Pay request that you edit the script 'OCCPROTXScriptTemplate.pl' within the folder called 'CommonOCC' beneath the 'OCCUpgrade' folder on your machine. If you have not done this you will need to add your encryption password and email address (if used) again.