Lane Number

Certain market segments may be required to send a lane number for each transaction to identify the lane it came from. This is a unique 8-digit number for each lane at a merchant location. If the provided lane number is not 8 digits, then an attempt to perform a transaction will result in an ECLTransactionInvalidLaneNumber error.

Code Samples

CWS

Request

Method Description
parameters
JSONObject | required
All relevant parameters for lane number.
laneNumber
string | required
8-digit lane number

Example (Request)

{
  "method" : "startPaymentTransaction",
  "requestId" : "1578283620",
  "targetType" : "paymentGatewayConverge",
  "version" : "1.0",
  "parameters" : {
    "paymentGatewayId" : "d5b9ea11-a9a7-4888-8458-2f609656579f",
    "transactionType" : "SALE",
    "tenderType" : "CARD",
  .....
    "laneNumber" : "72548638",
  .....
  }
}

Java

// ECLTransactionInterface that will be passed to processTransaction call
ECLTransactionInterface transaction;
transaction.setTransactionLaneNumber("72548638");

Objective-C

// ECLTransactionProtocol that will be passed to processTransaction call
id<ECLTransactionProtocol> transaction;
[transaction setTransactionLaneNumber:@"72548638"];

C#

// PaymentArgs that will be passed to CWS.StartPaymentTransaction(...) call
PaymentArgs paymentArgs = new PaymentArgs();
paymentArgs.laneNumber = "72548638";