AppFrontier

☰ Menu

Moneris eSELECTplus Salesforce Integration Chargent


Integrating Moneris eSELECTplus with Salesforce using Chargent

Overview


Moneris is one of North America’s leading payment processors. Moneris processes more than 3 billion credit and debit card transactions per year for over 350,000 merchant locations in Canada and the United States. Moneris handles Visa, MasterCard, American Express, Discover, INTERAC Direct Payment, and all POS solutions. Moneris’ eSELECTplus is an easy to use, multi-functional software application that processes card payment. eSELECTplus is accessed with a web browser eliminating the need for an application installation.

Integration with Chargent allows the ability to provide a seamless process for completing payment for orders managed in Salesforce. The integration utilizes Moneris eSELECTplus’ eCommerce module to accept major credit card payments in U.S. and Canadian dollars. Chargent provides for separate gateways for processing U.S. and Canadian dollars. The gateway will use different production and testing endpoints for communication with Moneris depending on whether U.S. or Canadian dollars are processed. In addition ACH transactions, including utilizing tokens, can be processed by U.S. gateways but not Canadian gateways. Canadian gateways can accept Interac Online payments but U.S. gateways cannot (Please note: Chargent does not currently support the Moneris Interac integration.) See Setting Up Salesforce For Integration for additional information on the gateways.

Moneris Logo

Setting Up Integration


This section contains the procedures for setting up the integration between Moneris and Salesforce. Each subsection under this section contains a separate procedure, however, the procedures must be completed in the order presented.

Setting Up Moneris eSELECTplus For Integration

This subsection contains the procedure for setting up eSELECTplus for the integration with Salesforce. Note: This procedure must be completed before starting Setting up Salesforce.

  1. Log into your Moneris developer account, or register for one.

  2. Obtain a merchant account as described in step 1 of Getting Started. Note: A Merchant ID (Moneris Store ID) and Merchant Security Key (Moneris API Key) will be sent upon acceptance.


Setting Up Salesforce For Integration

This subsection contains the procedure for setting up Salesforce for the integration with Moneris.

Notes:
  1. Install Chargent’s Gateway Package in Salesforce as described at Chargent Installation. Note: The production installation includes a free 30 day trial license. The sandbox installation has a free developer’s license.

  2. Install one of Chargent’s Transaction Packages in Salesforce as described at Chargent Installation. Note: The Transaction Packages are Chargent Orders, Opportunities, or Cases.

  3. Configure the basics of Chargent, such as assigning user licenses and updating page layouts. For more information please consult our Quick Start Guide.

  4. Select Chargent app in upper right hand corner of Salesforce.

    SalesForce chargent app


  5. Click the Gateway tab.

    Linked2Pay Chargent Gateway

  6. Click New.

    Linked2Pay Chargent New Gateway

  7. Select Moneris (CA) or Moneris (US) record type. Please choose the one that corresponds to your Moneris account (Canada or United States). Click Continue.

    Moneris Chargent Gateway Record Type

  8. Enter following fields:


    Moneris New Gateway

  9. Click Save.

Testing the Integration


This section contains the procedure for testing the integration set up in Setting Up Integration, using Moneris’ test credentials in Salesforce.

Note: Moneris provides shared values for its test environments.

To access the US test store, please use the following credentials.
https://esplusqa.moneris.com/usmpg/index.php
Username: demouser
Store ID: monusqa002
Password: abc1234

To access the Canada test store, please use the following credentials
https://esqa.moneris.com/mpg/index.php.
Username: demouser
Store ID: store3, store2 or store1
Password: password

The test values store1, store2, store3, or store5 can also be used for Merchant ID. “yesguy” can be used for the test Merchant Security Key.

  1. Click on tab that corresponds to the Chargent Transaction Package that was installed during the Setting Up Salesforce procedure. For the purposes of this example, Order was installed.

    Testing Chargent Orders

  2. Click New.

    Testing Chargent New

  3. Enter/select Subtotal / Amount, Gateway, Payment Information, Billing Information (including Email), and Credit Card fields, and click Save. Notes:

    • Use the following credit card numbers for testing with a future expiration date:

      • MasterCard - 5454545454545454
      • Visa - 4242424242424242
      • American Express - 373599005095005
      • Diners - 36462462742008

    • Use the following values for approved test Subtotal values

      • For Visa, use values between $11.00 to $49.99, $60.01 to $119.99, and $130.01 to $150.00.
      • For MasterCard and Diners, use $0.08.
      • For American Express, use an amount ending in zero cents except for $5.00.

    • Use the following values for non-approved test Subtotal / Amount values

      • For Visa, use
        • 0.01 for “Call For Auth” response
        • 0.02 for “Call For Auth/ Refer - Issue call” response
        • 0.03 for “Declined/Merchant not on file” response
        • 0.04, 0.07, and 0.41 for “Hold card/call/capture” response
        • 0.05 and 0.06 for “Declined” response
        • 0.09 for “Declined System problem/Retry/Duplicate transaction” response
        • 0.12, 0.57, and 0.58 for “Declined/Invalid transaction” response
        • 0.13 for “Declined/Invalid advice amount” response
        • 0.14 for “Call For Auth/Ineligible account” response
        • 0.15 for “Declined/Invalid destination” response
        • 0.19 and 0.20 for “Declined/Unable to authorize” response
        • 0.21 for “Declined System Problem /Retry/Unable to authorize” response
        • 0.22 for “Declined - error 050” response
        • 0.24 for “Declined/Unable to process” response
        • 0.43 for “Hold card/call/capture; CAF status 3” response
        • 0.51 for “Declined/Low funds” response
        • 0.54 for “Declined/Expired card” response
        • 0.61 for “Call For Auth/Over daily limit” response
        • 0.62 for “Declined/Restricted” response
        • 0.63 for “Declined Cannot Process/Retry/Unable to authorize” response
        • 0.65 for “Declined/Number times used” response
        • 0.68 for “System Timeout” response

      • For MasterCard and Diners, use
        • 0.01 for “Call For Auth Refer to Card Issuer” response
        • 0.05 for “Declined Do Not Honor” response
        • 0.14 for “Invalid Card Number” response
        • 0.41 for “Hold Card/Call/Capture Lost Card” response
        • 0.43 for “Hold Card/Call/Capture; CAF status” response
        • 0.75 for “Allowable number of PIN tries limit exceeded - Maestro only” response
        • 0.96 for “Invalid transaction, rejected” response

      • For American Express, use
        • 5.00 for “Transaction Not Approved DECLINED * DECLINED” response
        • 5.07 for “Transaction Not Approved REFERRED* CALL AMEX” response
        • 5.09 for “Transaction Not Approved DECLINED * INVALID MERCHANT” response
        • 5.11 for “Transaction Not Approved DECLINED * ACCT ERROR-RETRY” response
        • 5.15 for “Transaction Not Approved DECLINED * SERVICE ERROR” response


    Testing New Chargent Order

  4. Click Charge.

    Testing Chargent Charge

  5. Verify successful transaction and click OK.

    Testing Chargent Successful Transaction

  6. A Transaction record is created, containing the response messages and details received from eSELECTplus.

Going Live


This section contains the procedure for making the integration available for production systems. This procedure should not occur until the testing procedure described in Testing the Integration is successful.

  1. Obtain production Moneris account’s username and password.

  2. Repeat Setting Up Moneris eSELECTplus For Integration using production Merchant ID (Moneris Store ID) and Merchant Security Key (Moneris API Key).

  3. Repeat Setting Up Salesforce For Integration for production Salesforce.

  4. Repeat Testing the Integration for production integration using the production Merchant ID and Merchant Security Key obtained during Setting Up eSELECTplus For Integration, at least one real credit card transaction, and one real ACH transaction using company or personal accounts. Note: Void the transaction after test if needed.


Troubleshooting

  1. Moneris returning "Cancelled: Transaction not allowed.No permission for:'cvd_info’"

    If you are receiving the error message:

    Transaction not allowed.No permission for:'cvd_info'

    With the Moneris payment gateway, this is a setting on the Moneris side.

    The solution is to make sure the CVD feature is enabled on your Moneris account. You may need to speak with Moneris support or your sales representative to get it enabled.


  2. Moneris returning "SQL Problem”

    If you are receiving the message back from Moneris of “SQL Problem”, this is generally an issue with your credentials.

    Check that you have the correct Moneris Store ID entered in the Salesforce Gateway Merchant ID field, and correct Moneris API Key entered in the Salesforce Gateway Merchant Security Key.

    You should also check that you have selected the correct record type for your integration (Moneris Canada or United States).

    If problems persist, please contact Moneris for additional assistance.


Tokenization

This section contains the procedure for setting up using the tokens that are passed between Chargent and eSELECTplus. Moneris eSELECTplus uses a token system in order to maximize security of the data.

  1. Select Chargent app

    Tokenization Chargent App

  2. Click Gateway tab in Chargent app.

    Tokenization Gateway

  3. Click on Gateway used for integration

    Tokenization Test Moneris Gateway

  4. Double click on Use Tokenization field.

    Use Tokenization Field

  5. Click Use Tokenization checkbox.

    Use Tokenization Checkbox

  6. Double click on Credit Card Data Handling field.

    Credit Card Data Handling field

  7. Click on Credit Card Data Handling field and click on value. The results of the values are:

    • Never Clear - Chargent will not automatically remove card data.
    • Clear After Successful Charge - Chargent will clear the credit card number, expiration dates, and card security code only after a successful charge has occurred for the card.
    • Clear After All Transactions - Chargent will erase the credit card number, expiration date, and card security code after any approved transaction (Charge, Void, Refund) has occurred for the card.
    • Clear When Token Present - Chargent will erase the credit card number, expiration date, and card security code after any approved transaction (Charge, Void, Refund) for the card when a token is present in the token field.

    Credit Card Data Handling

  8. Click Save.

Note: The token is stored in Chargent's Token field in Salesforce after your first successful transaction, and the credit card fields are handled as specified in the procedure.

Field Mapping

This section contains mapping information between eSELECTplus and Salesforce fields.

Salesforce Direction iATS Payments
Gateway ID < Order ID
Order Source: ecommerce > WEB
Order Source: Corporate Cash Disbursement > CCD
Order Source: Prearranged Payment and Deposit > PPD