Authorize Method

Sends an authorization request.

Syntax

[VB.NET]
Public Sub Authorize()

[C#]
public void Authorize();

Remarks

This method sends an authorization request to the Datawire System, which will forward the request on to the FDMS processor. If the authorization request was successful, the CaptureFlag property will be True, and the ApprovalCode will contain an approval code.

An authorization blocks funds on the customer's credit card, but does not actually transfer funds. In order for funds to be transferred and the transaction completed, you must settle the transaction. To do this, you must pass an XML aggregate containing the results of the transaction to the Settlement component. For example:

	FDMSECommerce.Card = new CCCard("4444333322221111", 12, 2012);
	FDMSECommerce.Authorize();
	if (FDMSEcommerce.Response.CaptureFlag) {
		FDMSSettle.DetailRecords.Add(new FDMSRecordType(FDMSEcommerce.GetDetailAggregate()));
	}

Important Note: You must ping your list of service provider URLs and update the URL property to the service provider with the shortest response time every 100 transactions, as well as when your application initially starts. This is not a normal ICMP ping - to determine the fastest transaction URL you must use the special Ping method inside the FDMSRegister component. (You may update your list of service provider URLs with the FDMSRegister component's ServiceDiscovery method).