iPOS TransactLevel3/VISA CEDP
Sale-PaymentToken-L3
Submits a Sale transaction using a payment token ID, with Level 3 (VISA/CEDP) line-item data included to qualify for better interchange rates.
Header Parameters
token*string
Authentication token generated using the API Key and Secret Key. Required for all API requests.
Request Body
application/json
Response Body
application/json
application/json
curl -X POST "https://example.com" \ -H "token: string" \ -H "Content-Type: application/json" \ -d '{ "merchantAuthentication": { "merchantId": "962923571839", "transactionReferenceId": "7687678687457er3444d4r4e3983" }, "transactionRequest": { "transactionType": 1, "amount": "233", "paymentTokenId": "", "applySteamSettingTipFeeTax": true }, "preferences": { "eReceipt": true, "customerName": "Shankar", "customerEmail": "sthanigaivel@denovsystem.com", "customerMobile": "+918072892144" }, "L3Data": { "Header": { "TaxAmount": 1.23, "LocalTaxFlag": 1, "NationalTaxAmount": 2.23, "DestZipCode": "23432", "SummaryCommodityCode": "", "TaxRateApplied": 6, "TotalDiscountAmount": 1.25, "PoNumber": "10123456", "FreightAmount": 10, "DutyAmount": 12, "ShipFromZipCode": "23234", "DestCountryCode": "840", "MerchantTaxId": "457896", "LineItemCount": 1, "AltTaxAmount": 1, "PurchaseIdentifier": "", "PurchaseIdFormatCode": "1", "OrderDate": "2025-10-16", "AltTaxIndicator": true }, "items": [ { "CommodityCode": "12345678901234", "Description": "Milk is a diary product", "ProductCode": "1234567890", "Quantity": 1, "UnitOfMeasure": "123456789ITM123", "UnitCost": 1, "TaxAmount": 3, "TaxRate": "", "DiscountAmount": 1, "DiscountRate": 23443678099, "DiscountIndicator": true, "NetGrossIndicator": false, "DebitCreditIndicator": "", "ExtLineAmount": "123456", "AltTaxID": 101, "TaxTypeApplied": "ccc123", "NationalTaxAmount": 2.25, "NationalTaxRate": 3, "TaxIndicator": 3 } ] } }'{
"iposhpresponse": {
"consumerId": "55TSKB6V3WUG",
"responseCode": "400",
"responseMessage": "Failed",
"errResponseCode": "05",
"errResponseMessage": "PLS TRY FULL PAN",
"transactionReferenceId": "7687678687457er3444d4r4e39851",
"transactionType": "1",
"transactionId": "40690497613257183920251126072756",
"amount": "233",
"totalAmount": "403",
"customFee": "100",
"localTax": "47",
"stateTax": "23",
"l2l3ValidationError": null,
"l2l3Flag": "N"
}
}{
"errors": [
{
"field": "cardNumber",
"message": "Invalid card number format."
}
]
}