After deploying all necessary files, open the Episerver Commerce Manager back-end site. Then, follow these steps.
Go to Administration > Order System > Payments > English (United States). The last option is the language in which you want to make the DataCash payment available.
Select Create new payment method
For System keyword, enter DataCash, the name of the folder created during deployment.
For Class Name, select EPiServer.Business.Commerce.Payment.DataCash.DataCashPaymentGateway.
For Payment Class, select EPiServer.Business.Commerce.Payment.DataCash.Orders.DataCashPayment.
Click OK to save the DataCash payment method.
Open the DataCash payment method for additional editing.
Go to the Parameters tab and enter the following:
Host address. The URL of the DataCash server to which to send transactions (required).
vTID. DataCash account number (required).
Password. Password for vTID (required).
Log file. The log file to which the API writes the output log. The folder that contains the log file should be available. Make sure that the IUSR and IIS_IUSRS have modify permission for this file. If you do not set the log file, no logging occurs.
Time out. Number of seconds for transaction time out. If you do not set a time out, the default is 60 seconds.
Logging level. The level that should be logged.
Payment page Id. The ID of the payment page (configured by DataCash) that you want to display.
Proxy. The URL of a proxy to connect through. If you do not set a proxy, the server's default proxy is used.
Open the Markets tab and add the expected markets for this payment.
In Commerce Manager, navigate to Administration > Order System > Meta Classes.
Click Import MetaData to populate the MetaData import screen.
Select the DataCash/DataCashPaymentMetaClass.xml file to import.
Note: For testing purposes, manually request DataCash to activate HPS and the 3rd Man service. (These services are not configured by default. Also, the 3rd Man service is available for live accounts only.)
Setting up DataCash payment provider in the front-end site
To set up the DataCash payment provider, browse to the front-end Commerce site and follow these steps.
Navigate to theCMS > Admin > Content Typetab.
Add two properties, DataCashPaymentPage, DataCashPaymentLandingPage of the type Page, to the Start page (or Home page) page type.
Navigate to CMS > Edit.
Create a page using a DataCash Payment Page under a Checkout page, then publish it.
Open the site's home page, click theSite Structuretab and define two new properties:
Set the DataCashPaymentPage property to the DataCash page that was just created.
Set the DataCashPaymentLandingPage property to Order confirmation page.
Configuring the DataCash hash key (optional)
DataCash uses a private hash key to ensure security in communications. This private hash key is used to create secure hash keys, which are appended to an accept URL and a cancel URL.
The information about accept URL and cancel URL is sent to DataCash using HTTPS, so these keys are not exposed. When DataCash redirects a user to those URLs, the keys verify that the request comes from DataCash only, since only DataCash knows about the keys. You can configure this hash key in the application settings configuration section under DataCashHashKey.
DataCash user experience
After you deploy the files and configure the DataCash Payment module on your Episerver Commerce website, a DataCash option should appear in your checkout page. This section explains how a user interacts with PayPal.
During checkout, on the checkout page, select DataCash as the payment method.
When you click Place order, you are redirected to DataCash.com to confirm the payment.
When you finalize the approval process, you are redirected to the Order confirmation page (previously configured).
Note: DataCash.com checks billing and shipping addresses very carefully. If you test with a US address, use a correct and complete one with ZIP code, state, and city. Otherwise, the DataCash API precheck fails, and you cannot complete the payment.