4D Payments SDK 2016 .NET Edition

Questions / Feedback?

IncrementalAuth Method

Performs an incremental authorization.


public void IncrementalAuth(string transactionId, string validationCode);
Public Sub IncrementalAuth(ByVal TransactionId As String, ByVal ValidationCode As String)


This method sends an incremental authorization request through Datawire to the FDMS transaction processor and is used to add additional amounts to a previously authorized amount. The EntryDataSource field determines whether Track1, Track2, or manually entered card and expiration date are sent in the request. If the authorization request was successful, the CaptureFlag property will be True, and the ApprovalCode will contain an approval code.

TransactionId is used to specify the ID of the originally authorized transaction. ValidationCode is used to specify the validation code returned in the response from the originally authorized transaction.

The amount of the IncrementalAuth is specified via TransactionAmount.

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:


  FDMSHotel.CardEntryDataSource = edsManuallyEntered;
  FDMSHotel.CardNumber = "4444333322221111";
  FDMSHotel.CardExpMonth = 03;
  FDMSHotel.CardExpYear = 12;
  FDMSHotel.TransactionAmount = "5.00"; // Incremental Auth Amount
  FDMSHotel.IncrementalAuth(FDMSHotel.ResponseTransactionId, FDMSHotel.ResponseValidationCode);
  if (FDMSHotel.ResponseCaptureFlag) {    
  	//The AuthorizedAmount and SettlementAmount must include the sum of the incremental amount and 
  	//the original AuthorizedAmount.
		//If the transaction was originally for $10.00 and a $5.00 incremental amount is added the new
		//SettlementAmount should be "15.00"
		FDMSDetailRecord.AuthorizedAmount = "15.00"; // FDMSDetailRecord.AuthorizedAmount + FDMSHotel.TransactionAmount
    FDMSDetailRecord.SettlementAmount = FDMSDetailRecord.AuthorizedAmount; // Provided you wish to settle the entire authorized amount
    FDMSSettle.DetailRecords.Add(new FDMSRecordType(FDMSDetailRecord.GetDetailAggregate()));
Industry regulations do not allow merchants or processors to store track data in any form of persistent storage. Failure to abide by this regulation can result in significant fines and other penalties.

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).

Copyright (c) 2021 4D Payments Inc. - All rights reserved.
4D Payments SDK 2016 .NET Edition - Version 16.0 [Build 8017]