Configuring a Payment Gateway Tutorial

Introduction

Welcome. This is a brief tour explaining how to configure payment methods and gateways.
During this tour, we’ll also show how to place a test order and process it through Accounts Receivable.

Payment Methods

To begin, navigate to:

Configuration Checkout Payments

Click on the Configuration menu link and navigate to the Payments screen.



The first tab shown is payment Methods. Each payment method contains configuration fields that display when checked. Simply Click on Credit Card to view the configuration screen. 



We’ll choose them all for now by clicking the adjacent check boxes. There’s additional information we can fill out for each card, but we’ll skip that for now.
Scroll down and save your changes.

Clicking another tab also saves your changes! It's quicker, but this tutorial takes the long route to ensure you don't get lost.

Configuring Payment Gateway within Transaction Gateways tab

Reenter the Payments screen and click on the Transaction Gateways tab.



Each transaction gateway also displays configuration fields when clicked as you will see below. We are going to use the UltraCart Test Gateway to simulate a transaction but you'll need to eventually integrate your actual payment gateway in place of the test gateway.

Understanding the UltraCart Test Gateway

What is the UltraCart Test Gateway

The UltraCart Test Gateway is to be used for the initial testing of various aspects of your configurations prior to configuring the actual gateway.

The UltraCart Test Gateway does not actually process any authorization against a credit card. It simply simulates that step, returning an approval for the placed order. So, make sure that you remove the UltraCart Test Gateway from your configuration when you configure your actual credit card gateway.

At times you may need to test various cart settings. You can still place test orders using the UltraCart test credit card numbers which will not involve your gateway.

Scroll down and click the UltraCart Test Gateway check box.



Enter your Merchant ID and select the cards you wish to accept. We’ll select only 3 cards in this example. When finished, scroll to the bottom and save your changes.

Understanding the UltraCart Test Credit Card Numbers

Test Credit Card number DOES NOT test gateway

Please note that the test credit card is not meant to test the gateway configuration. The test credit card is useful for generating orders without incurring transaction fee's..

To test the configuration of your actual gateway it's best to create a real order using real credit card details. Some gateways show an option for a test gateway which allows you to temporarily place the gateway into the test mode and then use the specific card numbers your gateway provides for testing purposes.

To learn more about the Test Credit Cards, see: Test Credit Card or Electronic Check Payments


Creating a Test Order

Now lets create a test order by adding an item to our cart. In this example the gateway is set to send orders to Accounts Receivable for authorization.

Navigate to:

Store Items

Scroll down to a random item, and click the Item Links hyperlink 


From the Links screen, simply click on the "open in new window" button to send the item into the cart. 


Once in the cart, fill out the shipping information. When I finish adding my address, the shipping preference will update with precise shipping prices. I’ll leave the shipping at FedEx: Smart Post.

At the bottom, I’ll enter my test credit card number. The expiration date can be anything in the future, and the card verification number can also be any 3 digit number.

 


When my order is placed, I’ll remember my order id.

Authorizing the Test Order

Note: don't be confused by the fact that we used a different order to demonstrate the Authorize process.

Navigate to:

I see my order at the top of the Credit Card list. I can verify it’s my order by viewing it (clicking on it).



Check the Order ID check box and click the “Authorize Orders” button.



You are not quite finished yet. At the bottom of the batch authorize screen is a place for me to approve the order. Please notice the merchant note at the bottom of the order indicating that this was a test payment (because we used our test credit card).



Clicking the Process Payments button will fire off the batch processing.

This can take some time if you have a lot of orders but for one order, it’s almost simultaneous.
My order was authorized and there were no errors.

I can then navigate to Order Management  Shipping and continue with the next steps in order management.

That’s it. We’ve created an order and authorized payment. Congratulation!

A video of this tutorial is embedded in Page 3 of the Getting Started Guide (look for the green section and expand it).