Register Method

Registers a merchant account on the Datawire VXN.

Syntax

[VB.NET]
Public Sub Register()

[C#]
public void Register();

Remarks

For the North, Nashville, and Omaha platforms: FDMS will supply you with a MerchantNumber, MerchantTerminalNumber, and Datawire will supply the URL to use to register your merchant. After setting the above properties, call the Register method. The Register method will send the registration request to Datawire, and will continue to poll the Datawire servers until a response is received. This may take several seconds, or even several minutes.

When the registration is complete, the registration response returns the merchant's DatawireId, and the PrimaryDiscoveryURL and SecondaryDiscoveryURL needed to perform ServiceDiscovery. Once received, these parameters must be saved permanently so that they can be reloaded and configured when necessary and are never lost due to power outages.

For example:

  FDMSRegister.MerchantNumber = "000000999990";
  FDMSRegister.MerchantTerminalNumber = "555555";
  FDMSRegister.TransactionNumber = "1"; //any unique number will do.
  FDMSRegister.URL = "https://stagingsupport.datawire.net/staging_expresso/SRS.do";
  FDMSRegister.Register(); 
  FDMSRegister.TransactionNumber = FDMSRegister.TransactionNumber + 1;
  FDMSRegister.Activate();
  FDMSRegister.ServiceDiscovery(FDMSRegister.PrimaryDiscoveryURL);
  for (int i = 0; i < FDMSRegister.ServiceProviders.Length; i++) {
    FDMSRegister.Ping(FDMSRegister.ServiceProviders[i]);
    Console.WriteLine(FDMSRegister.ServiceProviders[i] + " = " + FDMSRegister.PingResponseTime);
  }

For the Rapid Connect platform: ServiceDiscovery will need to be performed first. After a successful ServiceDiscovery call, URL will be populated with the URL required to provision your merchant account. Once TransactionNumber and ApplicationId are set, Register can be called. The Register method will send the registration request to Datawire, and will continue to poll the Datawire servers until a response is received. This may take several seconds, or even several minutes.

When the registration is complete, the registration response returns the merchant's DatawireId, and the PrimaryDiscoveryURL and SecondaryDiscoveryURL needed to process transactions. Once received, these parameters must be saved permanently so that they can be reloaded and configured when necessary and are never lost due to power outages.

For example:

  FDMSRegister.MerchantNumber = "000000999990";
  FDMSRegister.MerchantTerminalNumber = "555555";
  FDMSRegister.Config("GroupId=10001");
  FDMSRegister.TransactionNumber = "1"; //any unique number will do.
  FDMSRegister.ServiceDiscovery("https://prod.dw.us.fdcnet.biz/sd/srsxml.rc");
  FDMSRegister.ApplicationId = "RAPIDCONNECTSRS";
  FDMSRegister.TransactionNumber = FDMSRegister.TransactionNumber + 1;
  FDMSRegister.Register(); 
  FDMSRegister.TransactionNumber = FDMSRegister.TransactionNumber + 1;
  FDMSRegister.Activate();