Click or drag to resize

AdministrationClientPointsTransferTransaction Method

Submit a Points Transfer Transaction, for a nominated Points amount. The From Card Number and To Card Number are specified in the request.

The updated Card Ponts Balance is returned.

Remarks
  • TransactionID is optional. If no TransactionID is submitted, then a unique TransactionID is returned by the Service
  • The submitted Transaction Date must be Less Than or Equal to the current Date and Time
Syntax
C#
public ResultOfPointsTransferTransactionProduct PointsTransferTransaction(
	ManagementGroupRequestOfPointsTransferTransaction request
)

Parameters

request
Type: AdministrationServiceManagementGroupRequestOfPointsTransferTransaction

Return Value

Type: ResultOfPointsTransferTransactionProduct
Examples
C#
using (var svc = new AdministrationService.AdministrationClient())
{
  var request = new AdministrationService.ManagementGroupRequestOfPointsTransferTransaction();
  request.Token = "Token";//Required - Token returned from AccountService.ManagementGroupLogin
  request.ManagementGroup = "Management group";//Required - ManagementGroup supplied when calling AccountService.ManagementGroupLogin

  var pointsTransferTransaction = new AdministrationService.PointsTransferTransaction();
  pointsTransferTransaction.PartnerID = "Partner ID";//Required
  pointsTransferTransaction.FromCardNumber = "21000005"; //Required
  pointsTransferTransaction.ToCardNumber = "21000109"; //Required
  pointsTransferTransaction.TransactionDate = DateTime.Now; //Required
  pointsTransferTransaction.AdjustmentReference = "New card"; //Required
  pointsTransferTransaction.TransactionID = "Transaction ID"; //Optional - must be unique. Will be generated if not supplied
  pointsTransferTransaction.AdjustmentReason = "INTERACCOUNT"; //Required - Valid values are : 'INTERACCOUNT' or 'GROUPBUILDERINTERACCOUNT'

  pointsTransferTransaction.TransferAllPoints = true; //Optional
  pointsTransferTransaction.CloseCard = true; //Optional
  pointsTransferTransaction.AdjustmentInternalNote = string.Empty; //Optional
  pointsTransferTransaction.AdjustmentReasonNotes = string.Empty; //Optional
  pointsTransferTransaction.ClientVersion = string.Empty; //Optional
  pointsTransferTransaction.ItemDescription = string.Empty; //Optional
  pointsTransferTransaction.TransactionAdjustmentValue = 0; //Optional
  pointsTransferTransaction.TransactionNotes = string.Empty; //Optional

  //Optional Custom Values
  var profileCustomFieldValues = new AdministrationService.ProfileCustomFieldValues();
  profileCustomFieldValues.CustomText_1 = string.Empty; //Optional CustomText_2 - CustomText_15 available
  profileCustomFieldValues.CustomBoolean_1 = false; //Optional CustomBoolean_2 - CustomBoolean_20 available
  profileCustomFieldValues.CustomDate_1 = DateTime.MinValue; //Optional CustomDate_2 - CustomDate_15 available
  profileCustomFieldValues.CustomDecimal_1 = 0.0M; //Optional CustomDecimal_2 - CustomDecimal_5 available
  profileCustomFieldValues.CustomInteger_1 = 0; //Optional CustomInteger_2 - CustomInteger_10 available
  pointsTransferTransaction.CustomFieldValues = profileCustomFieldValues;

  request.Value = pointsTransferTransaction;

  AdministrationService.ResultOfPointsTransferTransactionProduct result = svc.PointsTransferTransaction(request);

  if (result.FaultCode == 0)
  {
    //Request succeeded
  }
  else
  {
    //Request failed
    throw new Exception(result.FaultDescription);
  }
}
See Also