Convert Auth Only to Sale

This transaction converts the previous authorization to a Sale and places the transaction into an Open batch for settlement. The transaction status will not change as the pended Pre-Auth will only be converted to a pended Sale.

Code Samples

CWS

Request

Property	Description
method string \| required	`startPaymentTransaction`
requestId string \| required	Transaction Request ID
targetType string \| required	`paymentGatewayConverge`
parameters JSONObject \| required	All relevant parameters for Pre-Auth Complete transactions.
paymentGatewayId string \| required	Payment Gateway ID Unique identifier of the payment gateway as returned in the `openPaymentGateway` transaction response.
transactionType string \| required	Transaction Type Valid value: PRE_AUTH_COMPLETE
originalTransId string \| required	Transaction ID Unique transaction identifier of the pre-authorized transaction. Important: The status of the Pre-Auth transaction must be Open.
baseTransactionAmount JSONObject \| required	Transaction Amount If not passed, the Pre-Auth will be converted to a Sale for fully authorized amount. If passed, the Pre-Auth will be converted to a Sale for the amount that was passed as part of the Pre-Auth Complete. Important: The transaction amount must not be greater than the original authorized amount.“baseTransactionAmount” : { “currencyCodeStr” : “USD”, “amountInMinorUnits” : 1900 },
tenderType string \| required	Tender Type Valid value: CARD

Example

Request

 {
  "method" : "startPaymentTransaction",
  "requestId" : "19183389",
  "targetType" : "paymentGatewayConverge",
  "version" : "1.0",
  "parameters" : {
    "paymentGatewayId" : "fa4742cc-f370-425f-92b7-35010a05c0ef",
    "transactionType" : "PRE_AUTH_COMPLETE",
    "originalTransId" : "070316A15-55BFC2A6-5210-4641-BE1E-B3D06259C3DD",
    "baseTransactionAmount" : {
      "value" : 3427,
      "currencyCode" : "USD"
    },
    "tenderType" : "CARD",
    "cardType" : null,
    "isTaxInclusive" : false,
    "taxAmounts" : [{
      "value" : 0,
      "currencyCode" : "USD"
    }],
  }
}

Response

{
  "requestId" : "19183391",
  "statusDetails" : "REQUEST_ACCEPTED",
  "data" : {
    "paymentGatewayCommand" : {
      "completed" : true,
      "eventQueue" : [ ],
      "chanId" : "91c12045-2764-4452-8583-67895fc674fc",
      "paymentTransactionData" : {
        "result" : "APPROVED",
        "authCode" : "******",
        "date" : "Mon Mar 07 13:08:16 MST 2016",
        "cardEntryType" : "UNKNOWN",
        "resultMessage" : "APPROVED",
        "cardScheme" : "VISA",
        "amount" : {
          "currencyCode" : "USD",
          "value" : 3427
        },
        "id" : "070316A15-55BFC2A6-5210-4641-BE1E-B3D06259C3DD",
        "transactionType" : "PRE_AUTH_COMPLETE",
        "approved" : "yes",
        "errors" : [ ],
        "maskedPan" : "******",
        "tenderType" : "CARD",
        "balanceDue" : {
          "currencyCode" : "UNKNOWN",
          "value" : 0
        }
      }
    }
  }
}

Java

Initialize Commerce SDK and receive an ECLAccountInterface instance named account.
Create a money object by specifying a currency code and an amount.
```
ECLMoney amount = new ECLMoney(ECLCurrencyCode.USD, 300L);
```

Add the unique transaction identifier of the pre-authorized transaction and create a transaction reference.

String originalTxnId = "abc123";
ECLTransactionInterface transaction = account.getTransactionProcessor().createPreAuthCompleteTransactionWithTotal(amount, originalTxnId);

Create a card tender instance.

ECLCardTenderInterface tender = account.getTransactionProcessor().createCardTender();

Objective-C

Initialize Commerce SDK and receive an ECLAccountInterface instance named account.

Create a money object by specifying a currency code and an amount.

ECLMoney *amount = [[ECLMoney alloc] initWithMinorUnits:200 withCurrencyCode:ECLCurrencyCode_USD];

Add the unique transaction identifier of the pre-authorized transaction and create a transaction protocol.

NSString *originalTxnId = @"abc123";
id<ECLTransactionProtocol> transaction = [[_account transactionProcessor] createPreAuthCompleteTransactionWithTotal:amount transactionID:originalTxnId];

Create a card tender instance.

id<ECLCardTenderProtocol> tender = [account.transactionProcessor createCardTender];

C#

Request

PaymentArgs bea = new PaymentArgs();

Money m = new Money(Money.CurrencyCodefromString("USD"), finalAmount);
bea.baseTransactionAmount = m;  
bea.transactionType = TransactionType.PRE_AUTH_COMPLETE;
bea.originalTransId = m_OriginalTransId;
bea.tenderType = TenderType.CARD;
bea.paymentGatewayId = m_PaymentGateId; 

m_CWS.StartPaymentTransaction(bea, MyNotifyCWSEvent, MyPaymentComplete);