uCommerce includes full API reference documentation and lots of helpful articles to help you build your e-commerce site as effortlessly as possible.
uCommerce comes with built-in support for ePay payments. This guide will walk you through getting uCommerce to work with ePay for payment processing.
Authorization is available for all plans with ePay, i.e. Light, Pro, and Business.
If you wish to acquire (capture), refund, or cancel payments ePay requires you to buy the Business plan. You can see how to enable this here.
If you haven't completed the steps from the General Setup of Payment Methods in uCommerce document you need to do that before you move on.
When the payment method is created and saved as described in here. The back-end displays the different settings you can set for ePay.
Changes needed in the ePay administration panel, so it will work with uCommerce. You can find the administration panel at https://ssl.ditonlinebetalingssystem.dk/admin/login.asp.
On the Menu on the left, click “Indstillinger–> Betalingssystemet”, then you should get a view like the one below. These are the settings we recommend. Make a random key out of some digits/characters.
On the same page you need to enter the domain that the callbacks is made to. This include all subdomains.
Now on the menu to the left, go to “API / Webservices –> Adgang”
Set a password if you are using a shared hosting environment
At the bottom type in the “IP address” of the webhost accessing the webservice. This needs to be the external ip address
Click “Opret IP-adresse” to save it
Now we need to edit the payment method.
Some of the below information are found in the ePay administration panel, so start by logging in if you aren’t already.
Unless you have implemented your own version of the callback handling, this should be set to “(auto)”.
Url the user is returned to after successfully authorizing her credit card.
Url the user is returned to if she cancels a purchase.
The “Indløsningsnummer” is unique for your account. This can be found in the menu “Indstillinger -> Betalingssystemet”. Also make sure that “Test mode” is not active, like it is on the picture below, if you’re setting up a production environment.
Password used for the webservice, if using a shared host. This can be found in the menu “API / Webservices -> Adgang”.
True/False indicating whether to use Md5. Its recommended to use Md5 for security reasons.
True/False indicating whether to use SplitPayment.
The Md5 key set in the administration panel.
This can be found in the menu “Indstillinger–> Betalingssystemet”.
Running a pipeline once a payment is authorized can be helpful if you need to complete the order once the customer returns to your site.
To run a “pipeline” once the callback if received and processed, you need to modify the database. If you used the name “ePay” for the payment method name, you can run this SQL query in the SQL Server Management Studio.
UPDATE uCommerce_PaymentMethod SET Pipeline = 'Checkout' WHERE Name = 'ePay'
or just edit it manually in SQL Server Management Studio.
Now the default piplline that comes with uCommerce will be run after each successful callback. This sets the Basket to an Order, gives it an OrderNumber, and other things.