Custom Direct Payment Gateway Web Service

 

The Direct Custom Payment Gateway Web Service option allows you to plug-in any payment gateway provider you desire. 

 

To configure the “Custom Direct Web Service” do the following:

 

1.   Go to the Store Admin Menu and click the “Payment Setup” button

 

 

 

2.   Click the “Payment Gateways” button on the top menu

 

3.   Select the “Custom Direct Web Service” from the gateway dropdown list

 

 

 

 

When the “Custom Direct Web Service” gateway option is selected in the payment gateway setup screen the following required fields are displayed:

 

Merchant ID - This is a required field for the gateway.  Merchant ID is a unique id that identifies you with the gateway provider. 

 

Password - This is the gateway password and is a required field. 

 

URL – Enter the URL of the payment gateway you want to post the credit card transaction to. 

 

For example:   https://secure.myservice.com/processcard.aspx

 

The custom web service gateway option performs an https post operation to the URL you enter in the “URL” field.  A secure SSL connection is initiated from the cart to the payment gateway URL to pass transaction data in name/value pairs. It is a standard https post “Request – Response” with hidden name value pairs (NVP).  The following are the required fields (parameters) in the request and response between the cart and the payment gateway:

 

Parameters Posted by SmithCart to the Payment Gateway

 

      Merchant ID

      Password

      Mode  =  "TEST" or “LIVE”

      Trans_Type = "SALE"

      Credit_Card_Number       

      Expiration_Date

      CVV2_Code

      Amount

      Billing_Name

      Address

      City

      State

      Zip

      Country

 

 

Response Parameters SmithCart expects back from the Payment Gateway

 

      AuthCode

      Status

      TransID

      Notes

      Amount

 

The cart expects the transaction response parameters from the payment gateway to be returned as an ampersand ("&") delimited string.  The gateway response parameters provide information about the status of a transaction whether it was accepted or declined as well as other information about the transaction.

 

The cart receives and parses the transaction response from the payment gateway and displays the results to the customer.

 

The custom gateway/web service option in the cart uses the standard WebRequest Class http://msdn.microsoft.com/en-us/library/system.net.webrequest.aspx in dot net to communicate with your payment gateway.  The integration and communication between the cart and the payment gateway is very similar to the Authorize.Net AIM payment gateway integration here http://www.authorize.net/support/AIM_guide.pdf