Skip to main content

level2level3

Level 2 and Level 3 (L2/L3) credit card processing refers to certain B2B card transactions for which the merchant might be eligible for lower credit card interchange rates. The lower rates may be available for merchants who provide more detailed information when processing card-not-present transactions. In order to be eligible for L2/L3 transactions:

  • Your merchant account must be properly configured by Paysafe.

  • The BIN of the credit card used for the transaction must be eligible –typically,these are government-issued credit cards.

Note: Not all processing gateways support this parameter. Contact your accountmanager for more information.

exemptLocalTaxboolean

This indicates whether or not local tax is exempted for the request. If set to true, then the localTaxAmount parameter will be ignored.

Note: This value defaults to false

Default value: false
Example: true
localTaxAmountnumber

This is the local sales tax applied to the purchase.

Example: 1500
nationalTaxAmountnumber

This is the national tax included in the transaction amount.

Possible values: <= 99999999999

Example: 0
freightAmountnumber

This is the freight or shipping portion of the total transaction amount.

Possible values: <= 99999999999

Example: 0
dutyAmountnumber

This is the duty associated with the import of the purchased goods.

Possible values: <= 99999999999

Example: 0
destinationZipstring

This is the postal/zip code of the address to which the purchased goods will be delivered. This field can be identical to the shipFromZip if the customer is present and takes immediate possession of the goods.

Possible values: <= 10 characters

Example: 90210
destinationCountrystring

This is the country to which the goods are being shipped. See Country Codes.

Possible values: <= 2 characters

Example: US
shipFromZipstring

This is the postal/zip code of the address from which the purchased goods are being shipped.

Possible values: <= 10 characters

Example: 90211
lineItems object

This is more detailed information about the items that are being purchased for Level2Level3 merchants

descriptionstring

This is a description of the item(s) being purchased.

Possible values: <= 50 characters

Example: Disney Cruise Line
productCodestring

This is a merchant-defined description code of the item being purchased.

Possible values: <= 12 characters

Example: DCL
quantitynumber

This is the quantity of the item.

Note: Max 4 decimals is allowed.

Possible values: <= 99999999999

Example: 4
unitAmountnumber

This is the unit price of the item being purchased, in minor units. The currency will be based on the account setting.

Possible values: <= 99999999999

Example: 120000
taxRatenumber

This is the tax rate used to calculate the tax amount. For example, if the tax rate is 10.5%, this value should be 10.5.

Note: Max 2 decimals allowed.

Possible values: <= 100

Example: 5
taxAmountnumber

This is the amount of any value-added taxes that can be associated with the purchased item, in minor units. The currency will be based on the account setting.

Note: Our system will not validate the accuracy of this value. The merchant's application must calculate this value correctly.

Possible values: <= 99999999999

Example: 24000
totalAmountnumber

This is the total amount of the line item, typically calculated as price multiplied by quantity, in minor units. The currency is based on the account setting.

Note: Our system will not validate the accuracy of this value. The merchant''s application must calculate this value correctly.

Possible values: <= 99999999999

level2level3
{
  "exemptLocalTax": true,
  "localTaxAmount": 1500,
  "nationalTaxAmount": 0,
  "freightAmount": 0,
  "dutyAmount": 0,
  "destinationZip": "90210",
  "destinationCountry": "US",
  "shipFromZip": "90211",
  "lineItems": {
    "description": "Disney Cruise Line",
    "productCode": "DCL",
    "quantity": 4,
    "unitAmount": 120000,
    "taxRate": 5,
    "taxAmount": 24000,
    "totalAmount": 0
  }
}