Payment Gateway » mPay

{{toc}}

h1. Deployment Guide

This guide is mainly for *first-time deployment*. For the subsequences deployment, you should only deploy the files you have modified.

> see also [[Programming Guide]]

*Steps:*

# Execute the [[Specification#Tables-Used|MPAY_INTERFACE]] SQL to create the payment interface table

# Follow the instructions in this [[FAQ#Exception-Illegal-key-size-or-default-parameters-being-thrown]] to remove the restriction on cryptographic strength.

** overwrite the existing policies files if exists

# Go to the *Files* tab, and then download the following certificate files:

** choose *one* only:

*** <code>cert_test.zip</code> - for *test* environment

*** <code>cert_prod.zip</code> - for *live* environment

# Extract the downloaded certificate file _(cert_test.zip *or* cert_prod.zip)_ and place it into the following location:

** <code>server.crt</code> - place it in <code>[/data/mpay]</code>

** <code>merchant.p12</code> - place it in <code>[/data/mpay]</code>

# Go to the *Files* tab again, then download the following libraries and then upload it to <code>[.../WEB-INF/lib]</code>:

** <code>bcprov-jdk14-125.jar</code>

** <code>MerchantAdmin.jar</code>

** <code>MerchantClient.jar</code>

# Prepare the following files and these files can be found in [[wiki#SCM|SCM]]:

** _Java class files_

*** all of the files in <code>my.com.eCosway.mpay</code>

** _properties files_

*** <code>/resources/properties/mpay.properties</code>

# edit the <code>mpay.properties</code> based on the [[wiki#Merchant-Account-Details|Merchant Account Details]].

# Deploy those files that prepared in the previous step to application server:

** _Java class files_ - *to* <code>[.../WEB-INF/classes]</code>

** _properties files_ - *to* <code>[.../WEB-INF/classes]</code>

# Restart the application server

# Done