Electronic Merchant Setup

MoversSuite Administration > Accounting and Financial Services > Electronic Merchant

 

Link your system to a merchant service provider and establish Online Payments functionality using this setup. Contact your merchant service provider to setup an account and obtain the data and credentials specified for this setup. Once this data is setup users can access Electronic Payments functionality.

 

NOTE: Fields are determined by the Electronic Service chosen; therefore, all fields may will not be used as each Electronic Service provider has their own requirements. Set the Electronic Service first to prompt the fields needed for that choice.

 

    For choosing Remedy as the Electronic Service:

Figure 108 shows the example for when Remedy Gateway is chosen for Electronic Service.

See Electronic and Online Payments Setup (Remedy) > the Electronic Merchant Setup step for instructions for completing this set up for Remedy.

 

    For choosing CSI Pay as the Electronic Service:

Figure 109 shows the example for when Constellation Payments (CSI Pay) is chosen for the Electronic Service option.

See Electronic and Online Payments Setup (CSI Pay) > the Electronic Merchant Setup step for instructions for completing this set up for CSI Pay.

 

Graphical user interface, text, application

Description automatically generated

Figure 108: Electronic Merchant Setup with Remedy set for the Electronic Service

 

Graphical user interface, text, application, email

Description automatically generated

Figure 109: Electronic Merchant Setup with Constellation Payments (CSI Pay) set for the Electronic Service

 

Refer to the Electronic and Online Payments topic for more information.

 

 

Technical Field and Function Information

 

The following table describes the fields and functions within this setup.

 

NOTE: Fields are determined by the Electronic Service chosen; therefore, all fields may will not be used as each Electronic Service provider has their own requirements. Set the Electronic Service first to prompt the fields needed for that choice. For reference, see Figure 108 for the Electronic Merchant Setup options for Remedy. See Figure 109 for the Electronic Merchant Setup options for Remedy.

 

Field/Function

Description

Tab: General

Merchant Name

Provide a name of the merchant account with which is processing your Electronic Payments (up to 50 characters). This name appears atop of the Secure Payment Form.

Electronic Service

Select a service processor for your Electronic Payments. MoversSuite currently supports the following provider:

Constellation Payments (CSI Pay)

Remedy Payments

Merchant Account Code

For CSI Pay only: This is the merchant identifier. CSI Pay provides this value when they approve a new merchant then they provide us with their credentials. Enter the account number provided by CSI Pay(up to 20 characters). This needs to be entered only when a new record is added.

Merchant Gateway Code

For Remedy only: This is the merchant identifier. This field is read-only. When a new record is added, this field will have the value “Populated on first upload”. Once the record is saved, the user needs to press the “Upload Electronic Merchant Settings…”

Currency Code

Defaults to USD. This will be the currency used for all transactions through this Electronic Merchant. Can be any valid 3-character ISO-4217 code.

Order Note Type

Specify Order Note Type for order notes while making Online Payments related transactions (credit card payments, refunds, etc.). You specify the Note Type for these Notes within the Order Note Type setting within the General tab. You can select from a list of existing types or add one through the Note Type Setup.

Merchant Preference Order

Use the Merchant Preference Order to determine the order in which the Electronic Merchants will appear to the user in any drop downs (lower numbers appear first).

Merchant’s Active Status

Use the Merchant’s Active Status to control if users can continue to use a given Electronic Merchant for that branch for various action types. This is how you can force a move from one electronic service to another over time and yet still allow refunds and voids and allow or not allow new sales on existing cards.

 

Inactive (for Remedy):

The Inactive checkbox will always be checked automatically until the Merchant Gateway Code has been obtained. It gets checked when user’s click the Save and there is no valid Merchant Gateway Code. This will be automatically checked once all steps for setting up this Remedy record are completed. Technically, it is unchecked once the Upload Electronic Merchant Setting button is clicked and results are successfully returned.

 

When checked, no sales, voids, refunds nor new online payment links are possible.

 

We only change the "Inactive" from checked to unchecked if the Merchant Gateway Code shows "Populated on first upload" and we get a valid code back. Users should be careful because the following two situations could occur:

1. User manually checks Inactive, saves the record but does not upload this to Remedy. In this case, this merchant will no longer work via MoversSuite nor via online payments, but Remedy does not know this.

2. User manually checks Inactive, saves the record, and does upload this to Remedy. Then, user manually unchecks Inactive, saves the record but does not upload this to Remedy. In this case, MoversSuite and online payments will try to do payments, but they will all fail because Remedy thinks this merchant is inactive. Online payments will get "internal error"

NOTE:  If you change the Inactive flag and or the public or private keys, upload it to Remedy. It doesn't hurt to upload it twice. Technically, Remedy doesn't "test" the public or private keys until they are activated.

 

Inactive (for all other payment providers)

When checked, no sales, voids, refunds nor new online payment links are possible.

 

Setting this initially is not advised during the “switching providers process” due to void and refunds not being allowed. Each company can determine when to set this status; however, once the account is closed with the First Provider, be sure to set this record to Inactive then.

 

If the Merchant’s Active Status is set to Inactive, be sure to remove all branches associated to the record using the Remove All button.

 

Disable New Sales and New Online Links

When checked, the merchant will no longer allow new sales charges. Voids and refunds can still be processed.

 

Disable New Cards/Bank Accounts/Online Links

When checked, the merchant will no longer allow new cards to be charged, new card captures to occur nor new online links to be generated. When checked it does allow, though, existing cards and online links to be charged and voids/refunds to be processed.

 

NOTE: Click this to stop the use of this electronic merchant for the transaction type indicated on the Electronic Merchant record. This is a way to move processing to another Electronic Merchant. 

 

The message in green shows what users can and cannot do with your current settings. As an example, the warning can be:

Warning: Merchant is fully active. The online payments feature has never been configured for this merchant (use Online Payments tab to change.)

 

Electronic Service Url

Use Production Url

Defaults to checked. Leave checked as it is required for behind the scenes systems.

 

Payment Service Url

The URL defaults to the correct payment service URL when the Electronic Service field is set.

MoversSuite processes electronic payments through this URL. Included in the information sent in the request are the Merchant Account Code and the login data set through Merchant Credentials.

Transaction types that permitted

For CSI Pay: Identify which Payment Type is to be available through the Capture New Payment Method screen (from AutoPay Setup (Recurring Billing))and the Credit Card/Bank Payment screens by ticking the option.

The options available to CSI Pay are:

For example, if you want only the Credit Card option available, place a checkmark next to “Can Process Credit Cards” and leave the two bank options unchecked.

 

For Remedy: Only the “Can Process Credit Cards” option is available.

This record was last modified on

By

The name of the MoversSuite user that last modified this record displays along with the date and time of the change.

Adjusting the actual deposit date from the charge/refund transactions date (Optional)

By default, this is always unchecked and, therefore, turned off.

Set Deposit Date Using Business Days Only

 

When checked, this allows the system to calculate approximately (which means it is not 100% guaranteed to be 100% accurate) when transactions will actually hit your bank account and then place transactions within batches by this calculated deposit date. This calculation uses business days, which are technically defined by the bank that interacts with this Electronic Merchant record. Business days are normally defined as Monday through Friday and exclude Holidays. MoversSuite has no way to differentiate “banking holidays” from your “company holidays”. The Admin screen for Holidays defines your recognized company holidays, should you choose to enter them.

Add This Many Business Days

 

This adds the specified number of business days to the date the deposit occurs on. This date is defined as the date at the SQL Server, adjusted for whatever time zone the transaction occurred in.

 

This adds one additional business day if the time of day of the transaction is equal to or exceeds the daily deposit auto close time.

 

For CSI Pay: CSI Pay recommends setting this to adjust by 2 business days

Daily Deposit Auto Close Time (use 24 hour clock)

 

For Remedy: Remedy provides us with the UTC time they processed each transaction. Hover over the field for a pop-up tool tip which assists in calculating the offset/adjustment.

For CSI-Pay: CSI Pay recommends setting the time to 23:59 and adjust the time to where your bank is located in relation to your SQL Server time zone. For example, if a SQL Server is in the Mountain time zone then:

 1) For an Eastern time bank use 2 adjust days and 22:00 or

 2) For a Pacific time bank use 1 adjust day and 01:00.

We use the UTC time they notify us of the result. What time the bank uses to determine “the time of the transaction” is unknown to us but is most likely before the time we use.

 

Be careful on how you enter the daily deposit auto close time.

•      00:00 = 12:00 midnight (start of day)

•      12:00 = 12:00 noon

•      23:59 is a special time (since you cannot enter 24:00). The value 23:59 would include up to 23:59:59.999.

Be careful to note the time zone of the “agreed cutoff time” and the time zone of your SQL Server and adjust the time you enter here accordingly. For example, if the agreed upon time is “6:00 pm Eastern Time”, but your SQL Server is using Mountain Time, then you would enter “16:00” here. Most EWS hosted Azure systems are using Mountain Time on the SQL Server.

 

There is a tool tip on the “Daily Deposit Auto Close Time” textbox that shows you the time your SQL Server saw when this admin screen was loaded to give you an idea (but not the name) of the time zone your SQL Server is currently using.

In most cases, this will take some tweaking and adjusting by looking at the time of some late night and early morning online transactions and seeing how your bank handles them.

Users can move cash receipts from one batch to another if this business day calculation is not quite right. Hopefully, for most calendar days, it should be closer than it was in the past (which was never correct).

Deposits are Credited on Saturdays

 

Check the “Deposits are credited on Saturdays” if the bank associated with this Electronic Merchant record makes deposits to your account on Saturdays.

Deposits are Credited on Sundays

 

Check the “Deposits are credited on Sundays” if the bank associated with this Electronic Merchant record makes deposits to your account on Sundays.

Adjust for Holidays

Check the “Adjust for Holidays” (as defined in the Admin Holidays screen) if the bank associated with this Electronic Merchant record DOES NOT make deposits to your account on Holidays.

For CSI Pay only: This flag defaults to being checked and allows the payment process to reference authentication credentials through MoversConnect, which  supports Payment Card Industry compliance. No Merchant credentials are entered for CSI Pay.

 

Credentials managed through MoversConnect are maintained by EWS Group. The flag is checked by default when creating new Electronic Merchant profiles when CSI Pay is chosen for the Electronic Service.

 

NOTE: If your version of MoversSuite does not have Use MoversConnect for Authentication, you will need to upgrade your version of MoversSuite. Contact EWS Support for help.

For Remedy only: Clicking the Merchant Credentials button opens the Electronic Merchant Credentials dialog. When Remedy creates the gateway, they create a Public Key and a Private Key for that account. Remedy then gives Support those keys to be entered here. After entering the Merchant Credentials, be sure to click Add on that record.

 

This information is required to process requests through the Payment Service URL.

 

IMPORTANT: By end of year 2022, the option to use Merchant Credentials for authentication will go away and your interface with CSI Pay will no longer work. If your version of MoversSuite does not have Use MoversConnect for Authentication, you will need to upgrade your version of MoversSuite. Contact EWS Support for help.

 

See Electronic Merchant Credentials for more information.

Upload Electronic Merchant Settings….

Used for Remedy: Once the record is saved, the user needs to press the “Upload Electronic Merchant Settings…” button, which does the following:

      Sends the value of the “Inactive” field to Remedy. If Inactive is checked, then this Electronic Merchant record can no longer process payments through Remedy.

      Sends the value of the Currency Code field to Remedy. From this point on, all Remedy transactions would be in terms of this Currency Code. Use USD for US Dollars and CAD for Canadian Dollars. Any valid ISO 4217 currency code can be used; therefore, if the value is not USD nor CSD, then we provide an informational message that the user should be certain that they have actually entered a valid ISO 4217 currency code.

Retrieves the Merchant Gateway Code that is assigned by Remedy. Each Remedy Electronic Merchant record will have a different Merchant Gateway Code and that is what keeps the cards and transactions separated within the Remedy back-end service.

For CSI Pay: This feature sends a request to the merchant service containing the credentials specified through the Merchant Credentials. When the process completes, a Credentials Verification Results dialog displays showing a successful verification or any error that may have occurred, such as invalid password.

NOTE:  This button is disabled while the record is being edited or being added.  Once the Save or Add button is pressed, this button becomes enabled.  It is verifying that the URL, credentials, and merchant Account ID will all work.

Branch Item

A Branch can be assigned to one Electronic Merchant profile for each payment processing provider available, such as Remedy Payment and CSI Pay. If a Branch is assigned multiple Electronic Merchant Setup profiles, then the user must choose with Electronic Merchant Setup profile to use on each transaction. Add branches that you wish to support Electronic Payments for the Electronic Service provider specified.

 

Use the Merchant Preference Order to determine the order in which the Electronic Merchants will appear to the user in any drop downs (lower numbers appear first).

 

Use the Merchant’s Active Status to control if users can continue to use a given Electronic Merchant for that branch for various action types. This is how you can force a move from one electronic service to another over time and yet still allow refunds and voids and allow or not allow new sales on existing cards.

 

The branches specified must also support Cash Receipts. See Electronic and Online Payments for details.

Click here to add a new Branch Item

Click to select an individual Branch which adds that Branch to the profile.

Click to add all Branches to this profile.

Click to remove all Branches from this profile.

Click to keep changes made the record, including those entered through the Merchant Credentials function.

 

Cancel

Revert changes to the record back to the last saved state.