Documentation Home

Aurus Environment Setup

Prerequisites

  • Users must establish their own sandbox accounts with Aurus in order to use the BroadleafCommerce Aurus payment functionality in a test environment. This can be done here: Contact Aurus for keys.

Set up your Aurus Account

Once you have established an account with Aurus, begin by including the Aurus Module dependency to your pom.xml.

Note: blc-aurus version 2.0.x uses iFrame integration and Web Services. All previous versions uses SDK

<dependency>
    <groupId>com.broadleafcommerce</groupId>
    <artifactId>broadleaf-aurus</artifactId>
    <version>2.0.0-GA</version>
    <type>jar</type>
    <scope>compile</scope>
</dependency>

Make sure to include the dependency in your core pom.xml as well:

<dependency>
    <groupId>com.broadleafcommerce</groupId>
    <artifactId>broadleaf-aurus</artifactId>
</dependency>

You should now begin to setup your environment to work with Broadleaf Commerce Aurus support.
The first step is to make Broadleaf Commerce aware of your Aurus account credentials.
This is accomplished through environment configuration (see Runtime Environment Configuration).

The Broadleaf Commerce Aurus module use Spring Rest Template for the HTTP calls. You can enable logging for debugging. Please follow this documentation https://www.baeldung.com/spring-resttemplate-logging
Also you can debug AurusPaymentClient.class and investigate responses

Broadleaf allows you to create your own property files per environment (e.g. common.properties, local.properties, development.properties, integrationdev.properties, integrationqa.properties, staging.properties, and production.properties)
You will need to enter the following key/value pairs in the appropriate locations and replace the "?" with your Aurus account details:

You can also store these configs in the Database by utilizing the blSystemPropertiesService

Properties File Config

  • gateway.aurus.merchantId=(provided by Aurus. Example: 100000020065)
  • gateway.aurus.storeId=(provided by Aurus. Example: 963212)
  • gateway.aurus.terminalId=(provided by Aurus. Example: 32679784)
  • gateway.aurus.apiUrl=(provided by Aurus. Example: https://uatds42.auruspay.com)
  • gateway.aurus.corpId=(provided by Aurus. Example: 4707)
  • gateway.aurus.domainId=(get from Aurus Web Portal documentation. Example: 1)
  • gateway.aurus.templateId=(get from Aurus Web Portal documentation. Example: 1)
  • gateway.aurus.tokenType=(get from Aurus Web Portal documentation. Example: 102)
  • gateway.aurus.urlType=(get from Aurus Web Portal documentation. Example: 1)

Note: All these properties for the API requests are described on the Aurus Web Portal https://docs.aurusinc.com/client_releases/swagger/adsdkspecification-6.14.1