Docdata

Sana Commerce 8.3
Your provider

Configure a Live Docdata Payment Module

Please note, that this chapter does not provide a full guide on how to implement the Docdata payment module with a live account. The installation of Docdata on the live environment is exactly the same as on the test environment.
This chapter provides only the steps which should be performed to move the Docdata payment module implementation from a test to live environment.

When the test Docdata PSP module is configured, do the following to use the Docdata payment module implementation with a live account:

Step 1: Request a live account from Docdata.

Step 2: Configure the live account (general settings) depending on the needs of the webshop administrator.

Step 3: In the Docdata backoffice configure the correct confirmation URL: Settings > View/Edit Merchant Profile > URL.

Step 4: Change the 'Update URL' value to the confirmation page of the webshop.
For example: http://DOMAIN/confirm/payment?id=

Step 5: Configure payment methods in the Docdata backoffice: Settings > Payment method names.

Create payment methods in the Sana Commerce database matching these payment profiles. More detailed information about payment methods can be found here.

Make sure that every payment method is correct for each website, country and language.

Step 6: In the 'web.config' file of the Sana Commerce frontend modify the following configuration settings for the Docdata payment module (to live environment):

Value Changes
endpoint_name In the <module name="DocData"...> section should be set to the name of the endpoint configuration value for the production environment. By default, after installation this value is set to the test endpoint: DocData_OrderApi_test. When the add-on is installed, there are two endpoints preconfigured in the 'web.config' file by default: one is DocData_OrderApi_test, which is used for the test environment and the other one is DocData_OrderApi_production, which is used for the production environment.
Therefore, in the <module name="DocData"...> section change the endpoint name value to DocData_OrderApi_production to connect Docdata to the production environment of the Docdata Order API.
merchant_password Should be changed to the live account password (account must be requested from Docdata).
PaymentPage Should be changed to the URL of the Docdata payment menu page on the production environment, which is: https://secure.docdatapayments.com/ps/menu?
DebugDomains Should be removed in the live environment.

Step 7: When everything is done and tested, keep an eye on the payment log in the following days to be sure that everything is configured correctly and that every PSP status is covered.