support@protx.com
 

VSP Form Shopping Cart Integration: Actinic




In order to use a third-party payment gateway, such as Protx, you need to ensure you have the correct version of Actinic, as only version 6 and above is set-up by default to work with the VSP Form integration type.

If you are using V5.11 or below of Actinic you must upgrade to a later version before trying to integrate with Protx. Actinic will advise how to go about this

http://www.actinic.co.uk


Setting up your Actinic cart

Once you have logged in to your Actinic admin area you need to select the 'Payment and Security' tab within 'Business Settings'.


 1. Payment options in Actinic are managed through  the Business Settings. The Business Settings are  accessed from the Settings menu in Actinic v8, and  the View menu in Actinic v7 and earlier.
 2. In the Business Settings, select the Payment and  Security tab, then click the + icon in the top left-hand  corner.
 3. Select Protx from the drop-down menu.
 4. Click Configure Method, enter your Protx ID and  Secret Key, and click OK. Then click OK again. Update  your web site, and your store will now be configured to  offer Protx as a payment method.


How to set-up your Protx integration with Actinic


Entering your Protx Encryption Password



To enter your encryption password please go to the 'OCCUpgrade' directory. Within this directory you will find a folder called 'CommonOCC'.

Find the file called 'OCCProtxScriptTemplate.pl' and open it with text editing software, such as 'Notepad'.

Once you have opened this file, look for the following lines of code:



Enter your user specific 'Encryption Password' in the $sPassword field replacing testvendor.

If you wish to receive e-mails from Protx when a transaction is completed, cancelled, not authorised etc. then enter your e-mail address in the $sConfirmationEMail field - If you don't want them, leave it blank.

OCCProtxScriptTemplate.pl (viewed through UltraEdit)





Updating OCC Upgrade file



The final step is to change the version number in the 'OCCUpgrade.ini' file, found in the 'OCCUpgrade' directory. In some versions of windows the file is only displayed as 'OCCUpgrade', but you can check by looking at the properties. Open it in a text editor as you did when updating the 'OCCProtxScriptTemplate.pl' file.

OCCUpgrade.ini (viewed through UltraEdit)





At the top of this file you will see the following text:

      [Version]
      Number=1045 (for example)


Increment this Number by 1 (so if it was 1045 for example, you will need to change the value to 1046) and save the file.




Close down Actinic


You should now close down Actinic and open it again. When you open Actinic again, you will see a message to say your payment service providers have been updated. You should accept this change and then continue.


Upload your web site


Once you have entered all the appropriate information you will need to re-upload your modified web site to your web server. This will then enable you to carry out test transactions against the Protx payment gateway.



Frequently Asked Questions


What if I don't have my vendor name and secret key yet?

A unique Vendor name and password are provided when Protx create a test account for you. This data is emailed to the contacts registered on the account. Please email support@protx.com if you need reminding of your passwords.

You must ensure that you have registered for an account with Protx, otherwise you will not be able to go Live. You can register for an account using the following URL: https://support.protx.com/apply/


I get an error message saying 'The VendorTxCode field may be missing or you may have used an incorrect encryption password'

This is normally caused by the encryption password being entered incorrectly in OCCProtxScriptTemplate.pl. The encryption password is the 16-character string that will look something like:

            IopFg1GhwzQSFhIm

This should not be confused with the Actinic Secret Key or Admin password. If you need reminding of your passwords please email support@protx.com


When I download my orders I get an 'Invalid Signature' status.

This is caused by the Actinic Secret Key being entered incorrectly. The Actinic Secret Key is the 12-character string that will look something like:

            KotwWr56RtaW

This should not be confused with the Encryption Password, which is 16 characters in length. If you need reminding of your passwords please email support@protx.com


My Vendor name appears on the Payment pages where it says "To Pay For". How can I change this?

Within Actinic, the default settings pick up the Actinic MerchantID, (which is your Protx Vendorname). To change the name that appears after the text "To Pay For" on the Protx payment pages you will need to change the following at your end:

  1. OCCProtxScriptTemplate.pl file

    You will need to amend the OCCProtxScriptTemplate.pl file located within your actinic directory. (OCCUpgrade/commonOCC/)

    You will need to find the following bit of code:

    $sCrypt .= "Description=Items from ". $sMerchantID . "&";

    and change to:

    $sCrypt .= "Description=Items from YOUR CHOICE OF WORDING&"; (make sure that the &"; remain)


  2. Then save the file.


  3. occupgrade.ini file

    Look for the following file within your Actinic directory (OCCupgrade /occupgrade.ini)

    Open the file and increase the version number by 1 (so if it was 1045 for example, you will need to change the value to 1046) Then save the file.

    (This acknowledges the changes you made in 1.)


  4. Open up your Actinic again and it should mention that a change has been made to your PSP.






Payment Types


Payment types are the type of transaction /method to which you send your transactions to the bank. The default setting within Actinic will be PAYMENT. This means the transaction will be passed to the bank for authorising and if successful, will be sent for settlement to the banks by Protx at 2am. (So funds will be transferred unless you decide to Void / cancel it).

Deferred & Release

A transaction is made and the bank authorises it. This transaction is held in the banks active transaction list and the customer's card is shadowed for the transactions amount. The VSP Admin Reports will show a Deferred transaction has taken place and will give you the option to Release the payment when you wish to ship the goods. The transaction would have taken place and the customer's card will have been shadowed, awaiting your 'release'. (No money would have changed hands unless you release the transaction)

When you wish to ship the goods, you click the 'Release' button on the transaction page in your Protx VSP Admin reports pages and the bank will go and get the money from the users account and put it into your account.

N.B: The shadow only lasts up to 7 days, depending on the card issuer, so if you ship your goods before the shadow expires, you will get your money. If you ship your goods after the shadow has expired, you will not know if you have been paid until you see you bank statement. The banks do not reply to the 'release' informing us if they still have the funds in their account.

You only have the option to 'Release' or 'Abort' the transaction. So the Deferred transaction type is not an option if you are wanting to part ship goods.

If you do not wish to ship and wish to abort the transaction, you can click 'Abort' button in your VSP Admin Reports pages.


I want to use the Deferred transaction type

If you wish to use the Deferred transaction type and are not sure if you are setup to do so, please email support@protx.com to request the desired transactions Type.

You will need to have this set up on your Protx account in order for you to use them.

Once allocated to your Protx account, you will need to amend your Actinic cart settings. Please follow 'What to do' section. You will have to make the amendments at your end. This is not something that Protx can do for you.


What to do

Actinic requires you to amend code in your shopping cart setup to use the DEFERRED transaction type.

Currently your TXType that you send to us will be 'PAYMENT'

If you wish to use 'DEFERRED' you will need to change the TXType in your OccProtxScripttemplate.pl file in your Actinic directory from:

'PAYMENT' to 'DEFERRED'

  1. Amend your OCCProtxScriptTemplate.pl file

    The OCCProtxScriptTemplate.pl file is located in the commonOCC folder in the OCCUpgrade folder within your Actinic directory. Open the file in an editor like notepad and search for 'TxType':

    $sHiddenValues .= "INPUT TYPE=HIDDEN NAME=\"TxType\" VALUE=\"PAYMENT\">\n";

    You will need to change the TXType from PAYMENT to DEFERRED

    $sHiddenValues .= "INPUT TYPE=HIDDEN NAME=\"TxType\" VALUE=\"DEFERRED\">\n";

    Then save the file.


  2. Amend the OCCUgrade.ini file

    The OCCUgrade.ini file located in the root of the OCCUpgrade folder in your Actinic directory. Open the file in an editor like notepad.

    At the top of the file are the lines that look like this:

          [Version]
          Number=1045 (for example)


    Increment this Number (so if it was 1045 for example, you will need to change the value to 1046) by 1 and save the file.


  3. Open up Actinic

    You should get a message informing you that a change has been made to your Payment Provider data and that it has been.

    When you amend your Actinic code to use a certain transaction type, all your transactions will then be processed as that transaction type.




Protx VSP Admin Reports pages

Your Protx VSP Admin reports pages will show the transactions as Payment, PreAuth or Deferred transactions.

If you wish to Release a Deferred transaction, you go into your Protx Reports pages and locate the transaction in question by using the 'Transaction' Button. Go into the transaction details page, (by clicking on the VendorTxCode) and click the 'Release' button at the bottom of the page.

If you do not wish to continue with the transaction, simply 'Abort' the Deferred transaction by clicking the 'Abort' Button.

It is up to you to amend your cart settings and to make sure that your cart is using the transaction type you want it to use.


How do I go Live

Once you have successfully tested your web site with Protx, simply send your logo and go-live request to golive@protx.com. The Protx Live team will check that you have completed the live criteria and will create a Live account on the Protx Live Servers. You will then be able to run in 'production mode'.

Your logo should be no larger than 200 pixels wide or 100 pixels high, and will be uploaded on to your live payment pages when your live account is created.

If you have a questions please email support@protx.com or contact Actinic directly.


When Live, my Site does not redirect to the Payment pages

When changing from 'test' to 'production' mode within Actinic, the 'next' button, that transfers the users to the payment pages, is removed. Some Java script is supposed to handle this process, to auto redirect the user, but it may not be present in your Actinic templates.

If you are having issue directing the users to Protx, you can put the next button back.

  1. Amend your act_occprotxtemplate.html file

    Look for the following file within your Actinic directory. (OCCupgrade / CommonOcc/ act_occprotxtemplate.html). Open this file, find and amend the following:

    NETQUOTEDEL:TESTMODE
    INPUT TYPE=SUBMIT NAME="\"SUBMIT\"" VALUE="Next>"
    NETQUOTEDEL:TESTMODE


    You will need to change this to:

    INPUT TYPE=SUBMIT NAME="\"SUBMIT\"" VALUE="Next>"

    Basically removing the two references of NETQUOTEDEL:TESTMODE

    Save the file


  2. Amend the OCCUgrade.ini file

    The OCCUgrade.ini file located in the root of the OCCUpgrade folder in your Actinic directory. Open the file in an editor like notepad.

    At the top of the file are the lines that look like this:

          [Version]
          Number=1045 (for example)


    Increment this Number (so if it was 1045 for example, you will need to change the value to 1046) by 1 and save the file.


  3. Upload Your Site

    Now that you have made changes to your setup you will need to re-upload your site.


  4. Test

    When you have uploaded your site please test to make sure the redirect works, when you click the next button.




Back to top