Please note

Payment data, such as credit card numbers, credit card codes and others are not saved into the database due to security reasons.

Please note

It is not secure to send credit card information as a part of payment gateway URL. Customers are usually asked for their credit card number after they have been redirected to the payment gateway itself. Otherwise, another way of sending credit card information should be used instead.

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="CustomGatewayForm.ascx.cs" Inherits="CMSEcommerce_Example_CustomGatewayForm" %>

<asp:Label ID="lblTitle" runat="server" EnableViewState="false" CssClass="BlockTitle" />

<asp:Label ID="lblError" runat="server" EnableViewState="false" CssClass="ErrorLabel" Visible="false" />

<asp:Label ID="lblCardNumber" EnableViewState="false" runat="server" />

<asp:TextBox ID="txtCardNumber" runat="server" />

using System;

using System.Data;

using System.Configuration;

using System.Collections;

using System.Web;

using System.Web.Security;

using System.Web.UI;

using System.Web.UI.WebControls;

using System.Web.UI.WebControls.WebParts;

using System.Web.UI.HtmlControls;

using CMS.EcommerceProvider;

using CMS.GlobalHelper;

public partial class CMSEcommerce_Example_CustomGatewayForm : CMSPaymentGatewayForm

{

  protected void Page_Load(object sender, EventArgs e)

   {

      // Initialize label    

       lblTitle.Text = "Your credit card details";

       lblCardNumber.Text = "Credit card number:";

   }

  /// <summary>

  /// Initializes form controls with customer payment data.

  /// </summary>

  public override void LoadData()

   {

      // Display customer credit card number

       txtCardNumber.Text = ValidationHelper.GetString(this.ShoppingCartInfoObj.PaymentGatewayCustomData["CustomGatewayCardNumber"], "");

   }

  /// <summary>

  /// Validates customer payment data.

  /// </summary>

  /// <returns></returns>

  public override string ValidateData()

   {

      if (txtCardNumber.Text.Trim() == "")

       {          

           lblError.Visible = true;

           lblError.Text = "Please enter your credit card number";

          return lblError.Text;

       }

      return "";

   }

  /// <summary>

  /// Process customer payment data.

  /// </summary>

  /// <returns></returns>

  public override string ProcessData()

   {

      // Save credit card number

      this.ShoppingCartInfoObj.PaymentGatewayCustomData["CustomGatewayCardNumber"] = txtCardNumber.Text.Trim();

      return "";

   }

}

using System;

using System.Collections.Generic;

using System.Text;

using System.Web;

using System.Collections;

using CMS.EcommerceProvider;

using CMS.GlobalHelper;

using CMS.UIControls;

using CMS.ExtendedControls;

namespace CMS.CustomProvider

{

  /// <summary>

  /// Class representing Custom Gateway processor.

  /// </summary>

  public class CustomGateway : CMSPaymentGatewayProvider

   {

      /// <summary>

      /// Returns payment gateway form with custom controls.

      /// </summary>

      /// <returns></returns>

      public override CMSPaymentGatewayForm GetPaymentDataForm()

       {

          try

           {

              return (CMSPaymentGatewayForm)this.ShoppingCartControl.LoadControl("~/CMSEcommerce/Example/CustomGatewayForm.ascx");

           }

          catch

           {

              return null;

           }

       }

      /// <summary>

      /// Process payment.

      /// </summary>

      public override void ProcessPayment()

       {          

          // Get payment gateway url

          string url = this.GetPaymentGatewayUrl();

          if (url != "")

           {

              // Initialize payment parameters

               Hashtable parameters = InitializePaymentParameters();

              // Add required payment data to the url

               url = GetFullPaymentGatewayUrl(url, parameters);

              // Redirect to payment gateway to finish payment

              this.ShoppingCartControl.Page.Response.Redirect(url);

           }

          else

           {              

              // Show error message - payment gateway url not found

              this.ErrorMessage = "Unable to finish payment: Payment gateway url not found.";

              // Update payment result

              this.PaymentResult.PaymentDescription = this.ErrorMessage;

              this.PaymentResult.PaymentIsCompleted = false;

              // Update order payment result in database

              this.UpdateOrderPaymentResult();

           }

       }

      /// <summary>

      /// Returns table with initialized payment parameters.

      /// </summary>

      /// <returns></returns>

      private Hashtable InitializePaymentParameters()

       {

           Hashtable parameters = new Hashtable();

           parameters["orderid"] = this.ShoppingCartInfoObj.OrderId;

           parameters["price"] = this.ShoppingCartInfoObj.TotalPrice;

           parameters["currency"] = this.ShoppingCartInfoObj.CurrencyInfoObj.CurrencyCode;

           parameters["cardnumber"] = Convert.ToString(this.ShoppingCartInfoObj.PaymentGatewayCustomData["CustomGatewayCardNumber"]);

          return parameters;

       }

      /// <summary>

      /// Returns payment gateway url with payment data in query string.

      /// </summary>

/// <param name="url">Payment gateway url.</param>

      /// <param name="parameters">Initialized payment paremeters.</param>

      /// <returns></returns>

      private string GetFullPaymentGatewayUrl(string url, Hashtable parameters)

       {

          foreach (DictionaryEntry parameter in parameters)

           {

              // Add payment data to the url

               url = URLHelper.AddParameterToUrl(url, Convert.ToString(parameter.Key), HttpUtility.UrlEncode(Convert.ToString(parameter.Value)));

           }

          return url;

       }

   }

}