the jackol’s den

18 October 2004

Authorize.Net Integration using C# / ASP.NET

Posted by Mikhail Esteves under: C#; Tips .

Call the function below to make a payment using Authorize.Net’s Advanced Integration Method (AIM).

private bool AuthorizePayment(string FirstName, string LastName, string Address,
    string City, string State, string ZIP, string Country, double Amount)
{
  string AuthNetVersion = "3.1"; // Contains CCV support
  string AuthNetLoginID = "YourLoginID";
  string AuthNetPassword = "YourPassword";
  // Get this from your authorize.net merchant interface
  string AuthNetTransKey = "YourTransactionKey";

  WebClient objRequest = new WebClient();
  System.Collections.Specialized.NameValueCollection objInf =
    new System.Collections.Specialized.NameValueCollection(30);
  System.Collections.Specialized.NameValueCollection objRetInf =
    new System.Collections.Specialized.NameValueCollection(30);
  byte[] objRetBytes;
  string[] objRetVals;
  string strError;

  objInf.Add("x_version", AuthNetVersion);
  objInf.Add("x_delim_data", "True");
  objInf.Add("x_login", AuthNetLoginID);
  objInf.Add("x_password", AuthNetPassword);
  objInf.Add("x_tran_key", AuthNetTransKey);
  objInf.Add("x_relay_response", "False");

  // Switch this to False once you go live
  objInf.Add("x_test_request", "True");

  objInf.Add("x_delim_char", ",");
  objInf.Add("x_encap_char", "|");

  // Billing Address
  objInf.Add("x_first_name", FirstName);
  objInf.Add("x_last_name", LastName);
  objInf.Add("x_address", Address);
  objInf.Add("x_city", City);
  objInf.Add("x_state", State);
  objInf.Add("x_zip", ZIP);
  objInf.Add("x_country", Country);

  objInf.Add("x_description", "Description of Order");

  // Card Details
  objInf.Add("x_card_num", "4111111111111111");
  objInf.Add("x_exp_date", "01/06");

  // Authorisation code of the card (CCV)
  objInf.Add("x_card_code", "123");

  objInf.Add("x_method", "CC");
  objInf.Add("x_type", "AUTH_CAPTURE");
  objInf.Add("x_amount", Amount.ToString());

  // Currency setting. Check the guide for other supported currencies
  objInf.Add("x_currency_code", "USD");

  try
  {
    // Pure Test Server
    objRequest.BaseAddress = 
      "https://certification.authorize.net/gateway/transact.dll";

    // Actual Server
    //(uncomment the following line and also set above Testmode=off to go live)
    //objRequest.BaseAddress =
    //  "https://secure.authorize.net/gateway/transact.dll";

    objRetBytes =
      objRequest.UploadValues(objRequest.BaseAddress, "POST", objInf);
    objRetVals =
      System.Text.Encoding.ASCII.GetString(objRetBytes).Split(",".ToCharArray());

    if (objRetVals[0].Trim(char.Parse("|")) == "1")
    {
      // Returned Authorisation Code
      this.lblAuthNetCode.Text = objRetVals[4].Trim(char.Parse("|"));
      // Returned Transaction ID
      this.lblAuthNetTransID.Text = objRetVals[6].Trim(char.Parse("|"));

      return true;
    }
    else
    {
      // Error!
      strError = objRetVals[3].Trim(char.Parse("|")) + " (" + 
        objRetVals[2].Trim(char.Parse("|")) + ")";

      if (objRetVals[2].Trim(char.Parse("|")) == "44")
      {
        // CCV transaction decline
        strError += "Our Card Code Verification (CCV) returned " +
          "the following error: ";

        switch (objRetVals[38].Trim(char.Parse("|")))
        {
          case "N":
            strError += "Card Code does not match.";
            break;
          case "P":
            strError += "Card Code was not processed.";
            break;
          case "S":
            strError += "Card Code should be on card but was not indicated.";
            break;
          case "U":
            strError += "Issuer was not certified for Card Code.";
            break;
        }
      }

      if (objRetVals[2].Trim(char.Parse("|")) == "45")
      {
        if (strError.Length>1)
          strError += "<br />n";

        // AVS transaction decline
        strError += "Our Address Verification System (AVS) " +
          "returned the following error: ";

        switch (objRetVals[5].Trim(char.Parse("|")))
        {
          case "A":
            strError += " the zip code entered does not match " +
              "the billing address.";
            break;
          case "B":
            strError += " no information was provided for the AVS check.";
            break;
          case "E":
            strError += " a general error occurred in the AVS system.";
            break;
          case "G":
            strError += " the credit card was issued by a non-US bank.";
            break;
          case "N":
            strError += " neither the entered street address nor zip " +
              "code matches the billing address.";
            break;
          case "P":
            strError += " AVS is not applicable for this transaction.";
            break;
          case "R":
            strError += " please retry the transaction; the AVS system " +
              "was unavailable or timed out.";
            break;
          case "S":
            strError += " the AVS service is not supported by your " +
              "credit card issuer.";
            break;
          case "U":
            strError += " address information is unavailable for the " +
              "credit card.";
            break;
          case "W":
            strError += " the 9 digit zip code matches, but the " +
              "street address does not.";
            break;
          case "Z":
            strError += " the zip code matches, but the address does not.";
            break;
        }
      }

      // strError contains the actual error
      lblMsg1.Text = strError;
      return false;
    }
  } 
  catch (Exception ex)
  {
    lblMsg1.Text = ex.Message;
    return false;
  }
}

Works well for me. You will need to tweak a few parameters in order to make it work for you but I suppose there isn’t much for you to change.

Note: If you get an error like “The underlying connection was closed: Unable to connect to the remote server.” it most probably has to do with your Internet Connectivity — a firewall or something that’s blocking the request. If this happens to you, try the code on your hosting server and it should all work fine.

31 Comments so far...

Leave a Reply

Name

Mail (will not be published)

Website