Merchants are responsible for any fees that may occur when processing transactions with Level 3 data.

Level 3 Restrictions

• Level 3 data can only be added to approved transactions pre-settlement.
• Level 3 data can only be added to transactions that are Level 3 eligible.
• • This can be determined by performing a GET on /transactions/{transactionId} and referencing the level3Eligible field:
    

    {
      response: {
        processor: {
          level3Eligible: true
        }
      }
    }

• Level 3 data is not supported on refunds.
• Level 3 data may only be added to a a transaction that does not already have Level 3 data associated with it.
• • To modify existing Level 3 data, first perform a DELETE to /transactions/{transactionId}/level3. Once the Level 3 data has been removed, you may POST new data to /transactions/{transactionId}/level3.

To force the level3Eligible field to false on a transaction in our PayJunctionLabs.com testing environment, process a transaction with amountBase set to $1.03. You can then trigger the validation error returned when attempting to add level 3 data to an ineligible transaction with POST /transactions/{transactionId}/level3.

Providing Level 3 data does not guarantee that the transaction will qualify for Level 3 interchange rates. Qualification depends on multiple factors such as card type and the quality of the Level 3 data provided with the transaction.

In addition, Level 2 data is a prerequisite to qualify for Level 3 interchange rates for most MCCs. At a minimum, this typically requires a non-zero tax amount.

level3Eligible=true in the transaction response data indicates that Level 3 data can be added to the transaction, it is not a confirmation or guarantee of qualification for Level 3 interchange rates.

API

POST /transactions/{transactionId}/level3

Fields

Item Fields

Usage

curl -X POST https://api.payjunction.com/transactions/{transactionId}/level3 \
-u "login:password" \
-H "Accept: application/json" \
-H "X-PJ-Application-Key: YOUR_PRODUCTION_APP_KEY" \
-d destinationZip=93101 \
-d items[]="{\"amountTotal\": 1.00, \"amountUnitCost\": 1.00, \"quantity\": 1.0000, \"description\": \"a description\", \"grossNetIndicator\": \"GROSS\", \"discountIndicator\": \"NOT_DISCOUNTED\", \"productCode\": \"productCode\", \"unitOfMeasure\": \"OZ\"}" \
-d items[]="{\"amountTotal\": 1.00, \"amountUnitCost\": 1.00, \"quantity\": 1.0000, \"description\": \"a description\", \"grossNetIndicator\": \"GROSS\", \"discountIndicator\": \"NOT_DISCOUNTED\", \"productCode\": \"productCode\", \"unitOfMeasure\": \"OZ\"}"

Error Handling

{
  "errors" : [ {
    "message" : "size must be between 0 and 10",
    "parameter" : "destinationZip",
    "type" : "invalid"
  }, {
    "message" : "This field is invalid.",
    "parameter" : "items[1].discountIndicator",
    "type" : "invalid"
  } ]
}

DELETE /transactions/{transactionId}/level3

On successful delete, returns HTTP Response 204 No Content.

Usage

curl -X DELETE https://api.payjunction.com/transactions/{transactionId}/level3 \
-u "login:password" \
-H "Accept: application/json" \
-H "X-PJ-Application-Key: YOUR_PRODUCTION_APP_KEY"

GET /transactions/{transactionId}/level3

Usage

curl -X GET https://api.payjunction.com/transactions/{transactionId}/level3 \ -u
"login:password" \ -H "Accept: application/json" \ -H "X-PJ-Application-Key:
YOUR_PRODUCTION_APP_KEY"

Example Response

{
  "amountDuty" : "1.11",
  "amountFreight" : "2.22",
  "destinationZip" : "93101",
  "shipFromZip" : "91737"
  "items" : [ {
    "amountDiscount" : "0.00",
    "amountTax" : "2.17",
    "amountTotal" : "9.87",
    "amountUnitCost" : "2.2200",
    "commodityCode" : "9504500000",
    "description" : "description",
    "discountIndicator" : "NOT_DISCOUNTED",
    "discountRate" : "0.00",
    "grossNetIndicator" : "NET",
    "productCode" : "812872019123",
    "quantity" : "1.0000",
    "taxRate" : "8.75",
    "taxType" : "941",
    "unitOfMeasure" : "EA"
    }, {
    "amountDiscount" : "0.00",
    "amountTax" : "2.17",
    "amountTotal" : "9.87",
    "amountUnitCost" : "2.2200",
    "commodityCode" : "9504500000",
    "description" : "description2",
    "discountIndicator" : "NOT_DISCOUNTED",
    "discountRate" : "0.00",
    "grossNetIndicator" : "NET",
    "productCode" : "812872019123",
    "quantity" : "1.0000",
    "taxRate" : "8.75",
    "taxType" : "941",
    "unitOfMeasure" : "EA"
  } ]
}