Set up and configure a Moneris payment gateway instance
Set up and configure a Moneris payment gateway instance by using the information in this article, including the configuration procedure, descriptions of the configuration fields, and reference for testing the payment gateway.
Before you set up and configure a Moneris payment gateway instance on your tenant, enable the Moneris payment gateway integration for your tenant. See Enable payment gateway integrations for your tenant for instructions.
Complete the following steps to set up and configure a Moneris payment gateway instance:
- Click your username in the upper right and navigate to Settings > Payments > Setup Payment Gateway.
- On the Configure Gateway Instance tab, select Moneris from the Gateway Type drop-down list.
- Click Create Gateway.
- On the gateway settings page, specify values for the configuration fields. See the following “Configuration fields” section for more information on the fields.
- Click Save Gateway Information.
Common configuration fields
There are some common fields you must complete for every gateway configuration. We recommend reviewing our Setup Payment Gateway documentation for information on these common fields:
- Use Gateway Test Environment
- Cards Accepted
- Default Authorization Amount
- Verify new payment method
- Verify updated payment method
- Store ID: The Store ID provided by Moneris when you sign up for a Moneris account.
- API Token: This API token is available in your Moneris account > Admin > Store settings. Copy the API token from Moneris to this Zuora gateway configuration field.
- Enable Custom Store ID and API Token: If you select this field, Zuora will use a Moneris Store ID and an API Token in the following Store Id Custom Field and API Token Custom Field fields.
- Store Id Custom Field: Before populating this field, create a custom field on the Zuora Account object for saving a store_id. When this setting is populated, the custom field value from the Zuora account will be used for all Moneris API requests, instead of the regular Store ID gateway setting.
- API Token Custom Field: Before populating this field, create a custom field on the Zuora Account object for saving an AES256 encrypted api_token. When this setting is populated, the custom field value from the Zuora account will be decrypted by Zuora and used for all Moneris API requests, instead of the regular API Token gateway setting.
- Secret Key for API Token Custom Field: Enter the secret key that Zuora should use to decrypt your encrypted api_token value(s) from the preceding custom field on the Zuora Account.
- eFraud: Moneris supports eFraud tools that include AVS (address verification services), CVV (card verification value) code checking, as well as the Verified by Visa and MasterCard SecureCode services. If you have the eFraud feature enabled in your Moneris merchant account, select this eFraud field as well in Zuora.
- Crypt: Select the crypt type that is most applicable for your payment transactions. If you are not sure which option to select, work with your Moneris support team to confirm the most appropriate option for your merchant account.
Test the configuration
We recommend that you test your payment gateway using both your payment gateway's test and production (live) environments. Once you have completed testing in the gateway's test environment, it is recommended that you perform a test in your live production environment with a real credit card. If there are any differences in the configuration of your testing and production accounts, testing in production ensures your production merchant account is set up properly and can successfully connect to the production environment.
You can use the test card information and testing scenarios provided by the gateway vendor to test your integration. See Moneris Merchant Resource Center for details.