Add-ons and ModulesDocdata PSP

Docdata PSP

Sana Commerce 8.2
Your provider

Docdata Specific Configuration Values

The table below provides the description of the Docdata payment module configuration values:

Name Description
merchant_name The name of the account that will be used by Docdata to process the payment. This information will be supplied by Docdata when creating the (test) account.
Default value: depends on the PSP account
merchant_password The password of the account that will be used by Docdata to process the payment. This information will be supplied by Docdata when creating the (test) account.
Default value: depends on the PSP account
profile The name of the profile that will be used by default when creating a cluster at Docdata. This value is overridden by the value of the 'profile' XML field from 'Fields' column in 'PaymentMethods' table, and it is used only when it is not set in database. More information about the profile field can be found in the Docdata documentation. This configuration value is required for the Docdata payment module.
Default value: standard
days_pay_period The amount of days the user will have in order to pay the order. For more information about this field, please refer to the Docdata documentation. This configuration value is required for the Docdata payment module.
Default value: 14
PostUrl The URL that will be called when creating a cluster within Docdata. This value will remain constant unless changed by Docdata or when migrating between live/test environments.
Default value: depends on the environment
statusUrl The URL that will be used to get the status of a payment from Docdata. This value will remain constant unless changed by Docdata or when migrating between live/test environments.
Default value: depends on the environment
return_url_success The URL within the Sana webshop to which the user will be redirected when a payment is successfully finished within Docdata. If this value is not set in the configuration, the value configured in the Docdata backoffice will be used. This can be a relative URL.
Default value: checkout/ordersubmit.aspx?id=
return_url_canceled The URL within the Sana webshop to which the user will be redirected when a payment has been cancelled by the user. If this value is not set in the configuration, the value configured in the Docdata backoffice will be used. This can be a relative URL.
Default value: checkout/orderfailed.aspx?id=
return_url_pending The URL within the Sana webshop to which the user will be redirected when a payment is still pending at the moment the user has finished the checkout flow at the PSP site. If this value is not set in the configuration, the value configured in the Docdata backoffice will be used. This can be a relative URL.
Default value: checkout/ordersubmit.aspx?id=
return_url_error The URL within the Sana webshop to which the user will be redirected if an unexpected error occurs while trying to pay at the PSP site. If this value is not set in the configuration, the value configured in the Docdata backoffice will be used. This can be a relative URL.
Default value: checkout/orderfailed.aspx?id=
DebugDomains In most cases it is not possible to test a PSP in a development environment without a deployment, because of firewall issues. For Docdata, it is possible to test in a development environment by simulating calls made by Docdata for testing purposes. These test calls will be made in all domains set in the configuration setting. Multiple values can be separated by the ',' character.
Default value: localhost

Important! This value is for testing purposes only! Never configure this value for a live domain as it may cause problems with payments.

DebugConfirmUrl This setting can be used only in combination with the DebugDomains setting. The test calls made to the domains in the 'DebugDomains' setting will be made to this page. In common cases this will be the confirm page URL of the webshop. A relative URL should be supplied. The {0} value will be replaced by the order Id.
Default value: checkout/PaymentConfirm.aspx?id={0}

More detailed information about general configuration values of the external payment method can be found here.

If you want to post some optional parameters open the 'web.config' file of the Sana Commerce frontend. Locate the <payment-configuration> node in the <sanaCommerce> configuration section, where several modules are defined, which implement different payment methods. The 'DocData' module is only needed. Add new configuration entry in the following format:

<add name="parameter name" value="parameter value" isRequestParameter="true" />
Add-ons and ModulesDocdata PSP