Formally named Virtual Merchant

1. In your FoxyCart admin under payments, select “Converge” in the gateway select box and enter your account details.
   1. When you set up your account, you should have received an email with the required Foxy credentials. Currently, the labels that Converge uses, mapped to the Foxy admin, are: ssl_merchant_id:–>account id, ssl_user_id:–>user id, and ssl_pin:–>pin.
   2. Optionally also configure card verification (to allow you to verify card details when a payment wouldn't otherwise be captured), and specify a “vendor id” if needed.
   3. Configure the default currency as per your Converge terminal's default currency
   4. If you have multicurrency (MCC) enabled for your Converge terminal, enable it in the Foxy gateway configuration to allow transactions in different currencies to your default terminal currency.
   5. Enable 3D Secure if that is enabled for your Converge terminal also.
2. Save the Converge configuration in your Foxy administration
3. Contact Converge merchant support and request that the CVV2 be set as _not required_ for your terminal. This can be done by contacting the SCSS team by email to scss@elavon.com or by phone at 800-377-3962.
   • This is necessary to allow returning customers and subscription payments to process through FoxyCart. FoxyCart will generally require the CSC in all other circumstances.
4. Contact Converge to let them know you'll be testing some transactions, and make sure that's ok with them.
5. Test a few transactions.
6. Test a few more.

Contact Elavon merchant support group at sccs@elavon.com or 1-800-377-3962 option 2 then option 2 to submit your request for a test account. Test accounts are good for 30 days but can be renewed if required.

When test cards are used, the amount in the “cents” column determines the response you get from the gateway. If you use the proper amount in the cents column, an “APPROVED” response should be returned, and the test transaction should be successful.

5472-0633-3333-3330 is a good test card number. Use any expiration date in the future. You'll want your amount to be a whole dollar amount (for example, $20.00) in order to get a successful response.

See chapter 8 (page 194) from the developer guide PDF at https://demo.myvirtualmerchant.com/VirtualMerchantDemo/supportlandingvisitor.do.

If you get an error “The field Invoice Number (ssl_invoice_number) required but not supplied in the authorization request. (Response Reason Code: 4009)”, please contact Elavon Support or FoxyCart Support.

By default, Converge supports a single currency per terminal - either USD or CAD. When configuring your Converge gateway for Foxy, you will specify which currency your terminal is in, which will limit purchases through Converge to this currency.

If you wish to offer multiple different currencies through your Foxy store, you can request the Converge team enable multi-currency support for your terminal. Once this is enabled, and you enable the Multicurrency option within the Foxy Converge configuration, you will then be able to allow customers to purchase in currencies other than your terminal's default option.

If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date. We reserve the right to edit or remove comments that don't add value to this page.