Add-on. Payment Method. a product for

Transcription

1 Add-on a product for

2 Index Introduction Installation Settings Errors Customize

3 Introduction Easily integrate CyberSource Secure Acceptance payment gateway to your concrete5 website with this add-on. Works seamlessly with the ecommerce add-on. Provides hassle free installs, uninstalls and reinstalls. You can change the transaction mode to Test or Live. Once you have tested the payment gateway fully with the Test mode, you just need to change the transaction mode to Live, enter the required details and you are good to go. There is also an option to choose the currency. Main features of CyberSource Secure Acceptance Web/Mobile: 1. Security Compliance hosted services mean faster and easier PCI certification 2. Reduced Risk no need to handle or store sensitive account data 3. Mobile Optimization users on mobile devices are presented with the best checkout experience 4. Global Ready Language packs cover all major ecommerce markets and more 5. Easy Trials and Testing Changes to the checkout pages are easily configured 6. Basic Customizing customize basic visual elements and messaging for your customers 7. Virtually Transparent customers move seamlessly from your product pages to our hosted order form 2

4 Installation 1. Download the Package from the Concrete5 website 2. After dowloading the zip file, extract it and paste it in "packages" folder in your concrete5 website root directory. 3. Go to your website in a browser and login as an administrator. 4. Go to the Dashboard page and click on "Extend concrete5" link. 5. In the "Awaiting Installation" section you will see "CyberSource ". Click "Install". 6. The package is now installed.! Before you install CyberSource package, make sure that you already have the ecommerce package installed, otherwise the CyberSource installation will give an error. Once you have installed ecommerce package then you can install CyberSource package. 3

5 Settings Open the Dashboard page. Under the "ECOMMERCE" section click on the "Payment & Sales Tax" link. It will show a list of all the payment methods currently installed with the ecommerce add-on. There will be a link for CyberSource. By default it will be disabled. Image: Screenshot of dashboard Click on the CyberSource link. It will open up a "Edit " page. Under the Details section you can change the Name of the payment method to your liking. To enable this payment method select Yes from the dropdown next to "Enabled". 4

6 Settings Under the "CyberSource Information" you will need to enter your CyberSource profile details. If you are going to work with your test profile, then set the Transaction Mode to Test otherwise select Live to enable live payments. From your CyberSource profile, you will need the following information: 1. Access Key (enter correct details) 2. Secret Key (enter correct details) 3. Profile ID (enter correct details) 4. Set the Transaction Type. Choose "Sale" for actual payments. 5. Choose the appropriate currency. The dropdown will provide the options. 5

7 Settings The Customer Response Pages contains links where the person will be redirected after making the payment or after canceling the transaction. These will be pre-populated. Just copy the links and paste it in your CyberSource profile. There are possibilities that these return URLs might change under circumstances like if you turned on/off pretty URLs or if you reinstalled the CyberSource package. Hence always ensure that the return URLs entered in your CyberSource profile matches the URLs given in this Settings page. Once, you are done with the above steps, click on Save. You will now have the CyberSource payment method Enabled. 6

8 Errors The details of every failed transcations are logged. To check the details of a failed transaction, go to "Logs" under the "REPORTS" section on your Dashboard page. For each failed transaction, there will be two entries in the log. The first entry is a simple message which gives the Order ID, error number and the error message. The second entry contains the full debug info. It prints the $_REQUEST array and the Order object. To set-up your CyberSource profile and to get the complete information regarding the payment gateway check out the CyberSource Secure Acceptance Web/Mobile Configuration Guide. Link: 7

9 Customize You might want to create your own single pages for success, cancel and error response from CyberSource. In that case, just change the return URLs in your CyberSource profile to your own single pages that you have created. The URLs that are present in the Settings page are just for your reference to get the add-on working directly for you but it doesn't restrict you from customizing and extending the functionality. You can refer to "action_transaction_response" method in cybersource payment method controller file to see how to handle the response and customize it to your liking in the single page controller (or your own tools file). If you are going to create your own single page, you will need to know one important step. For a successful transaction you will need to call finishorder method from CoreCommercePaymentController. Currently, since the response is handled in the controller file that extends CoreCommercePaymentController, just calling parent::finishorder is enough. However, that's not possible if you create your own single page. You cannot instantiate the CoreCommercePaymentController in your single page controller and call the finishorder method either because it is protected. The workaround is to create your own library that extends CoreCommercePaymentController and override the finishorder method and make it public and inside the method call the parent finishorder method. Now, in your single page controller you can instantiate your custom library that you just created and call the finishorder method and pass in the appropriate arguments. 8

10 You re all set to go!