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 SagePay payments. This guide will walk you through getting Ucommerce to work with SagePay for payment processing. Ucommerce integrates with SagePay using server integration.
Add a new payment method, under “Ucommerce –> Settings –> Orders –> Payment Methods”. You can call it whatever you like, here I have used “SagePay”.
Click the newly created node and select “SagePay” in the Service drop down list. Fill out the rest of the required information, like where it’s available from under the “Access” tab, pricing and the language tabs. When done click “Save”.
That’s everything in the Ucommerce interface.
You can learn more about how to configure SagePay in the SagePage Help Centre.
Now we need to edit the SagePay.config file.
You will find the SagePay.config file in the following location, where “rootdir” is the directory on the computer where you installed Umbraco: “rootdir\umbraco\UCommerce\Configuration\SagePay.config”. Usually “rootdir” is c:\inetpub.
Vendor is the name you use when you login with SagePay.
Debug mode indicates whether you want to have an intermediate page show up with the values, which will be posted to the payment gateway.
Testmode indicates whether your site is in simulation mode (SIMULATOR), test mode (TEST), or running in production mode (LIVE).
URL the customer is redirected to once the payment is accepted.
URL the customer is redirect to if she cancels payment authorization.
URL the customer is redirect to if the payment could not be authorized.
Ucommerce will generate a callback URL for internal use. Leave the setting at (auto) unless you need to handle callbacks yourself.
Running a pipeline once 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 “SagePay” 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 = 'SagePay'
or just edit it manually in SQL Server Management Studio.
Now the default pipeline 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.
To be able to acquire, cancel, and refund payments you need to enable two pipeline tasks in the ToCompletedOrder pipeline and ToCancelled pipeline.
The pipeline configuration is found in /umbraco/ucommerce/pipelines.
Testmode – Make sure test mode if turned off when going live.