Card processing can be categorized into different levels, with each level defined by how much data is required to process the transaction. Enhanced data levels, such as Level 2 and Level 3, require extra information to process the transaction and are most useful for corporations and government agencies that require this type of transaction detail to accurately monitor and track expenses. BlueSnap's Payment API supports Level 2/3 data processing for all currencies, allowing you to expand your business-to-business (B2B) and business-to-government (B2G) sales opportunities.

📘

Note

Be sure to send the correct Level 2/3 data. After that, it is up to the issuer to determine whether the transaction qualifies for a lower interchange rate. BlueSnap only validates the format of the data, not whether it meets issuer requirements, so keep in mind that passing data does not guarantee Level 2/3 savings.

This guide covers the following topics:

Before you Begin

  • Level 2/3 Data is supported for select configurations. Contact Merchant Support for more details.
  • Do not include the pipe character | in a Level 2 or Level 3 data field. Including the character causes fields to be parsed incorrectly.
  • If you don't know the card type, pass as many level3Data properties as you can.
    • If you pass a property that exceeds the maximum length, BlueSnap truncates the value to meet requirements.
    • If BlueSnap detects the card doesn't support Level 2/3 Data, the level3Data properties are not sent to the issuer.
  • If Level 3 data is sent in both the Auth Only and Capture requests, the Level 3 data from the Auth Only request will be ignored.
  • If Level 3 data is sent in the Auth Only request but not sent in the Capture, BlueSnap will include the Level 3 data from the Auth Only request with the Capture request.
  • If you manage your own subscriptions, you must send level3Data for each charge.

Back to Top

Data Levels

Card brandSupports
MasterCard            Level 2
Level 3
VisaLevel 2
Level 3
AmexLevel 2
Level 2 with TAA (Transaction Advice Addendum)
>Level 2 with TAA is an Amex-specific level that contains item data (such as item description and quantity) in addition to Level 2 fields. For more details, refer to Required properties for Amex.

Back to Top

Required Properties

Required for MasterCard

Required for MasterCard for Level 2 Data
Only the following are required for Level 2 Data:

  • customerReferenceNumber / customer‑reference‑number
  • salesTaxAmount / sales‑tax‑amount
     

Required for MasterCard for Level 3 Data
The following table outlines the required properties for Level 3 Data.

Hierarchy Property (JSON XML) Level 3 Details

Order level

For details regarding the specifics of a property, refer to:  level3Data (JSON)  or  level-3-data (XML)
customerReferenceNumber
customer‑reference‑number
Mandatory — If the value we receive is all spaces, we replace the value with NA.
salesTaxAmount
sales‑tax‑amount
Mandatory — If the value we receive is all spaces, we replace the value with all zeros.

freightAmount
freight‑amount
Not mandatory — However, if a value is sent and the value we receive is all spaces, we replace the value with all zeros.
dutyAmount
duty‑amount
Not mandatory — However, if a value is sent and the value we receive is all spaces, we replace the value with all zeros.
destinationZipCode
destination‑zip‑code
Not mandatory — However, if a value is sent and the value we receive is all spaces, we replace the value with 0.
destinationCountryCode
destination‑country‑code
Not mandatory — However, if a value is sent and the value is not valid, we replace the value with all spaces.
shipFromZipCode
ship‑from‑zip‑code
Not mandatory — However, if a value is sent and the value we receive is all spaces, we replace the value with 0.
discountAmount
discount‑amount
Not mandatory — However, if a value is sent and the value we receive is not a valid value (numeric 09), we replace the value with all zeros.
taxAmount
tax‑amount
Not mandatory — However, if the value is sent and it is not valid, we replace the value with all zeros. Also, if any value is sent, even all zeros, Tax Rate is required.
taxRate
tax‑rate
Mandatory if the Tax Amount is present — If the value we receive is not a valid value, we replace the value with all zeros.
level3DataItem
level‑3‑data‑item
Mandatory — Container for the data item properties shown below. See details below.

Item level

The following are the required data item properties. For details regarding the specifics of a property, refer to:  level3DataItems (JSON)  or  level‑3‑data‑item (XML)

Note: You may pass the following properties for each item. A maximum of 97 line items is supported. If you send more than 97 line items in the request, the first 97 will be accepted and the rest will be ignored.

lineItemTotal
line‑item‑total
Mandatory — If the value we receive is not a valid value (numeric 09), we replace the value with 1.
commodityCode
commodity‑code
Not mandatory
description
description
Mandatory — If the value we receive is all spaces or all zeros, we replace the value with NA.
discountAmount
discount‑amount
Not mandatory — However, if a value is sent and the value we receive is not a valid value (numeric 09), we replace the value with all zeros.
discountIndicator
discount‑indicator
Not mandatory — However, if the value is not Y or N, we replace the value with N.
grossNetIndicator
gross‑net‑indicator
Not mandatory — However, if the value is not Y or N, we replace the value with N.
productCode
product‑code
Mandatory — If the value we receive is all spaces or all zeros, we replace the value with NA.
itemQuantity
item‑quantity
Mandatory — If the value we receive is all spaces or all zeros, we replace the value with 1.
taxAmount
tax‑amount
Not mandatory — However, if the value is sent and it is not valid, we replace the value with all zeros. Also, if any value is sent, even all zeros, Tax Rate is required.
taxRate
tax‑rate
Mandatory if the Tax Amount is present — If the value we receive is not a valid value, we replace the value with all zeros.
taxType
tax‑type
Not mandatory — However, if a value is sent and the value we receive is not a valid value, we replace the value with all spaces.
unitOfMeasure
unit‑of‑measure
Not mandatory — However, if the value we receive is all spaces or all zeros, we replace the value with NA.

Back to Top


Required for Visa

Required for Visa for Level 2 Data
Only the following are required for Level 2 Data:

  • customerReferenceNumber / customer‑reference‑number
  • salesTaxAmount / sales‑tax‑amount
     

Required for Visa for Level 3 Data
The following table outlines the required properties for Level 3 Data.

Hierarchy Property (JSON XML) Level 3 Details

Order level

For details regarding the specifics of a property, refer to:  level3Data (JSON)  or  level-3-data (XML)
customerReferenceNumber
customer‑reference‑number
Not mandatory
salesTaxAmount
sales‑tax‑amount
Not mandatory

freightAmount
freight‑amount
Not mandatory — However, if a value is sent and the value we receive is all spaces, we replace the value with all zeros.
dutyAmount
duty‑amount
Not mandatory — However, if a value is sent and the value we receive is all spaces, we replace the value with all zeros.
destinationZipCode
destination‑zip‑code
Not mandatory — We do not change the value.
destinationCountryCode
destination‑country‑code
Not mandatory — However, if a value is sent and the value we receive is not a valid value, we replace the value with all spaces.
shipFromZipCode
ship‑from‑zip‑code
Not mandatory — We do not change the value.
discountAmount
discount‑amount
Not mandatory — However, if a value is sent and the value we receive is not a valid value (numeric 09), we replace the value with all zeros.
taxAmount
tax‑amount
Not mandatory — However, if the value is sent and it is not valid, we replace the value with all zeros. Also, if any value is sent, even all zeros, Tax Rate is required.
taxRate
tax‑rate
Mandatory if the Tax Amount is present — If the value we receive is not a valid value, we replace the value with all zeros.
level3DataItem
level‑3‑data‑item
Mandatory — Container for the data item properties shown below. See details below.

Item level

The following are the required data item properties. For details regarding the specifics of a property, refer to:  level3DataItems (JSON)  or  level‑3‑data‑item (XML)

Note: You may pass the following properties for each item. A maximum of 97 line items is supported. If you send more than 97 line items in the request, the first 97 will be accepted and the rest will be ignored.

lineItemTotal
line‑item‑total
Mandatory — If the value we receive is not a valid value (numeric 09), we replace the value with 1.
commodityCode
commodity‑code
Mandatory — If the value we receive is all spaces or all zeros, we replace the value with 00101.
description
description
Mandatory — If the value we receive is all spaces or all zeros, we replace the value with NA.
discountAmount
discount‑amount
Not mandatory — However, if a value is sent and the value we receive is not a valid value (numeric 09), we replace the value with all zeros.
productCode
product‑code
Mandatory — If the value we receive is all spaces or all zeros, we replace the value with NA.
itemQuantity
item‑quantity
Mandatory — If the value we receive is all spaces or all zeros, we replace the value with 1.
taxAmount
tax‑amount
Not mandatory — However, if the value is sent and it is not valid, we replace the value with all zeros. Also, if any value is sent, even all zeros, Tax Rate is required.
taxRate
tax‑rate
Mandatory if the Tax Amount is present — If the value we receive is not a valid value, we replace the value with all zeros.
unitCost
unit‑cost
Mandatory — If the value we receive is all spaces or all zeros, we replace the value with 1.
unitOfMeasure
unit‑of‑measure
Not mandatory — If the value we receive is all spaces or all zeros, we replace the value with NA.

 
Back to Top


Required for Amex

The following table outlines the required properties for Amex Level 2 with TAA (Transaction Advice Addendum). This is an Amex-specific level that contains item data (such as item description and quantity) in addition to Level 2 fields. Only the following fields are applicable.

Hierarchy Property (JSON XML) Amex Level 2 with TAA

Order level

For details regarding the specifics of a property, refer to:  level3Data (JSON)  or  level-3-data (XML)
customerReferenceNumber
customer‑reference‑number
Mandatory
salesTaxAmount
sales‑tax‑amount
Mandatory
destinationZipCode
destination‑zip‑code
Optional
level3DataItem
level‑3‑data‑item
Mandatory — Container for the data item properties shown below. See details below.

Item level

The following are the required data item properties. For details regarding the specifics of a property, refer to:  level3DataItems (JSON)  or  level‑3‑data‑item (XML)

Note: You may pass the following properties for each item. A maximum of 97 line items is supported. If you send more than 97 line items in the request, the first 97 will be accepted and the rest will be ignored.

lineItemTotal
line‑item‑total
Optional
description
description
Mandatory
itemQuantity
item‑quantity
Optional

Back to Top


Sending Level 3 Data Examples

Level 3 data is supported in Auth Capture, as well as in the Auth Only and Capture requests.

JSON Examples

Sample Auth Capture request and response

{
  "cardTransactionType": "AUTH_CAPTURE",
  "softDescriptor": "DescTest",
  "amount": 10.60,
  "currency": "USD",
  "cardHolderInfo": {
    "firstName": "test first name",
    "lastName": "test last name",
    "zip": "123456"
  },
  "creditCard": {
    "cardNumber": "4005 5192 0000 0004",
    "securityCode": "111",
    "expirationMonth": "09",
    "expirationYear": 2023
  },
  "level3Data": {
    "customerReferenceNumber": "1234A",
    "salesTaxAmount": 0.6,
    "freightAmount": 0,
    "dutyAmount": 0,
    "destinationZipCode": "12345",
    "destinationCountryCode": "us",
    "shipFromZipCode": "12345",
    "discountAmount": 0,
    "taxAmount": 0.6,
    "taxRate": 6.0,
    "level3DataItems": [{
      "lineItemTotal": 10.00,
      "description": "test_desc",
      "discountAmount": 0,
      "productCode": "test_code",
      "itemQuantity": 1.0,
      "taxAmount": 0.60,
      "taxRate": 6.0,
      "unitOfMeasure": "lb",
      "commodityCode": "123",
      "discountIndicator": "Y",
      "grossNetIndicator": "Y",
      "taxType": "test",
      "unitCost": 10.00
    }]
  }
}
{
  "cardTransactionType": "AUTH_CAPTURE",
  "vendorsInfo": {},
  "transactionId": "1015836179",
  "softDescriptor": "BLS*DescTest",
  "amount": 10.60,
  "currency": "USD",
  "avsResponseCode": "G",
  "cardHolderInfo": {
    "firstName": "test first name",
    "lastName": "test last name",
    "zip": "123456"
  },
  "vaultedShopperId": 22391925,
  "creditCard": {
    "cardLastFourDigits": "0004",
    "cardType": "VISA",
    "cardSubType": "CREDIT",
    "cardCategory": "CORPORATE T&E"
  },
  "level3Data": {
    "customerReferenceNumber": "1234A",
    "salesTaxAmount": 0.6,
    "freightAmount": 0,
    "dutyAmount": 0,
    "destinationZipCode": "12345",
    "destinationCountryCode": "us",
    "shipFromZipCode": "12345",
    "discountAmount": 0,
    "taxAmount": 0.6,
    "taxRate": 6,
    "transactionProcessedWithL3dSupportedAcquirer": true,
    "level3DataItems": [{
      "lineItemTotal": 10,
      "commodityCode": "123",
      "description": "test_desc",
      "discountAmount": 0,
      "discountIndicator": "Y",
      "grossNetIndicator": "Y",
      "productCode": "test_code",
      "itemQuantity": 1,
      "taxAmount": 0.6,
      "taxRate": 6,
      "taxType": "test",
      "unitCost": 10,
      "unitOfMeasure": "lb"
    }]
  },
  "processingInfo": {
    "processingStatus": "success",
    "cvvResponseCode": "NR",
    "avsResponseCodeZip": "U",
    "avsResponseCodeAddress": "U",
    "avsResponseCodeName": "U"
  },
  "fraudResultInfo": {
    "deviceDataCollector": "N"
  }
}

Sample Auth Only request and response

{
  "cardTransactionType": "AUTH_ONLY",
  "softDescriptor": "DescTest",
  "amount": 10,
  "currency": "USD",
  "cardHolderInfo": {
    "firstName": "test first name",
    "lastName": "test last name"
  },
  "creditCard": {
    "cardNumber": 4012000033330026,
    "securityCode": 111,
    "cardType": "VISA",
    "expirationMonth": "09",
    "expirationYear": 2023
  },
  "level3Data": {
    "customerReferenceNumber": "test",
    "salesTaxAmount": 87,
    "freightAmount": 10,
    "dutyAmount": 1,
    "destinationZipCode": "12345",
    "destinationCountryCode": "us",
    "shipFromZipCode": "12345",
    "discountAmount": 10,
    "vatTaxAmount": 3,
    "vatTaxRate": 3,
    "level3DataItems": [
      {
        "lineItemTotal": 12377,
        "itemCommodityCode": "123",
        "description": "test_desc",
        "discountAmount": 1,
        "discountIndicator": "Y",
        "grossNetIndicator": "Y",
        "productCode": "test_code",
        "itemQuantity": 10,
        "vatTaxAmount": 3,
        "vatTaxRate": 3,
        "taxTypeApplied": "test",
        "unitCost": 7,
        "unitOfMeasure": "usd"
      }
    ]
  }
}
{
  "cardTransactionType": "AUTH_ONLY",
  "transactionId": "38550326",
  "softDescriptor": "BLS*DescTest",
  "amount": 10.0,
  "usdAmount": 10.0,
  "currency": "USD",
  "avsResponseCode": "G",
  "cardHolderInfo": {
    "firstName": "test first name",
    "lastName": "test last name"
  },
  "vaultedShopperId": 19590368,
  "creditCard": {
    "cardLastFourDigits": "0026",
    "cardType": "VISA",
    "binCategory": "CONSUMER",
    "binNumber": "401200",
    "expirationMonth": "09",
    "expirationYear": "2023"
  },
  "level3Data": {
    "customerReferenceNumber": "test",
    "salesTaxAmount": 87,
    "freightAmount": 10,
    "dutyAmount": 1,
    "destinationZipCode": "12345",
    "destinationCountryCode": "us",
    "shipFromZipCode": "12345",
    "discountAmount": 10,
    "transactionProcessedWithL3DSupportedAcquirer": true,
    "level3DataItems": [
      {
        "lineItemTotal": 12377,
        "description": "test_desc",
        "discountAmount": 1,
        "discountIndicator": "Y",
        "grossNetIndicator": "Y",
        "productCode": "test_code",
        "itemQuantity": 10,
        "unitCost": 7,
        "unitOfMeasure": "usd"
      }
    ]
  },
  "networkTransactionInfo": {
    "originalNetworkTransactionId": "751005569293609",
    "networkTransactionId": "751005569293609"
  },
  "processingInfo": {
    "processingStatus": "success",
    "cvvResponseCode": "MA",
    "authorizationCode": "055099",
    "avsResponseCodeZip": "U",
    "avsResponseCodeAddress": "U",
    "avsResponseCodeName": "U",
    "networkTransactionId": "751005569293609"
  },
  "fraudResultInfo": {
    "deviceDataCollector": "N"
  }
}

Sample Capture request and response

{
  "cardTransactionType": "CAPTURE",
  "transactionId": "38550328",
  "level3Data": {
    "customerReferenceNumber": "test",
    "salesTaxAmount": 87,
    "freightAmount": 10,
    "dutyAmount": 1,
    "destinationZipCode": "12345",
    "destinationCountryCode": "us",
    "shipFromZipCode": "12345",
    "discountAmount": 10,
    "vatTaxAmount": 3,
    "vatTaxRate": 3,
    "level3DataItems": [
      {
        "lineItemTotal": 12377,
        "itemCommodityCode": "123",
        "description": "test_desc",
        "discountAmount": 1,
        "discountIndicator": "Y",
        "grossNetIndicator": "Y",
        "productCode": "test_code",
        "itemQuantity": 10,
        "vatTaxAmount": 3,
        "vatTaxRate": 3,
        "taxTypeApplied": "test",
        "unitCost": 7,
        "unitOfMeasure": "usd"
      }
    ]
  }
}
{
  "cardTransactionType": "CAPTURE",
  "transactionId": "38550328",
  "softDescriptor": "BLS*BS",
  "amount": 20.0,
  "usdAmount": 20.0,
  "openToCapture": 0,
  "currency": "USD",
  "transactionApprovalDate": "01/05/2021",
  "transactionApprovalTime": "07:58:07",
  "cardHolderInfo": {
    "firstName": "John",
    "lastName": "Blue",
    "email": "test@bluesnap. com",
    "country": "us"
  },
  "vaultedShopperId": 19590370,
  "creditCard": {
    "cardLastFourDigits": "1111",
    "cardType": "VISA",
    "cardSubType": "CREDIT",
    "binCategory": "CONSUMER",
    "binNumber": "411111",
    "cardRegulated": "Y",
    "issuingBank": "JPMORGAN CHASE BANK, N.A.",
    "expirationMonth": "7",
    "expirationYear": "2023",
    "issuingCountryCode": "us"
  },
  "level3Data": {
    "customerReferenceNumber": "test",
    "salesTaxAmount": 87,
    "freightAmount": 10,
    "dutyAmount": 1,
    "destinationZipCode": "12345",
    "destinationCountryCode": "us",
    "shipFromZipCode": "12345",
    "discountAmount": 10,
    "transactionProcessedWithL3DSupportedAcquirer": true,
    "level3DataItems": [
      {
        "lineItemTotal": 12377,
        "description": "test_desc",
        "discountAmount": 1,
        "discountIndicator": "Y",
        "grossNetIndicator": "Y",
        "productCode": "test_code",
        "itemQuantity": 10,
        "unitCost": 7,
        "unitOfMeasure": "usd"
      }
    ]
  },
  "networkTransactionInfo": {
    "originalNetworkTransactionId": "751005573403769",
    "networkTransactionId": "751005573403769"
  },
  "processingInfo": {
    "processingStatus": "SUCCESS",
    "cvvResponseCode": "MA",
    "authorizationCode": "772239",
    "avsResponseCodeZip": "U",
    "avsResponseCodeAddress": "U",
    "avsResponseCodeName": "U",
    "networkTransactionId": "751005573403769"
  },
  "fraudResultInfo": {
    "deviceDataCollector": "N"
  }
}

XML Examples

Sample Auth Capture request and response

<?xml version="1.0" encoding="UTF-8"?>
<card-transaction xmlns="http://ws.plimus.com">
  <card-transaction-type>AUTH_CAPTURE</card-transaction-type>
  <soft-descriptor>MYSTORE</soft-descriptor>
  <amount>10.60</amount>
  <currency>USD</currency>
  <card-holder-info>
    <first-name>test first name</first-name>
    <last-name>test last name</last-name>
    <zip>02453</zip>
    <country>us</country>
  </card-holder-info>
  <credit-card>
    <card-number>4005 5192 0000 0004</card-number>
    <security-code>111</security-code>
    <expiration-month>09</expiration-month>
    <expiration-year>2023</expiration-year>
  </credit-card>
  <level-3-data>
    <customer-reference-number>1234A</customer-reference-number>
    <sales-tax-amount>0.6</sales-tax-amount>
    <freight-amount>0</freight-amount>
    <duty-amount>0</duty-amount>
    <destination-zip-code>12345</destination-zip-code>
    <destination-country-code>us</destination-country-code>
    <ship-from-zip-code>12345</ship-from-zip-code>
    <discount-amount>0</discount-amount>
    <tax-amount>0.6</tax-amount>
    <tax-rate>6.0</tax-rate>
    <level-3-data-item>
      <line-item-total>10.60</line-item-total>
      <commodity-code>123</commodity-code>
      <description>test_desc</description>
      <discount-amount>0</discount-amount>
      <discount-indicator>Y</discount-indicator>
      <product-code>test_code</product-code>
      <item-quantity>1.0</item-quantity>
      <tax-amount>0.60</tax-amount>
      <tax-rate>6.0</tax-rate>
      <unit-of-measure>usd</unit-of-measure>
      <gross-net-indicator>Y</gross-net-indicator>
      <unit-cost>10.00</unit-cost>
    </level-3-data-item>
  </level-3-data>
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
    <card-transaction-type>AUTH_CAPTURE</card-transaction-type>
    <transaction-id>1020736769</transaction-id>
    <soft-descriptor>BLS&#x2a;MYSTORE</soft-descriptor>
    <amount>10.60</amount>
    <usd-amount>10.60</usd-amount>
    <currency>USD</currency>
    <avs-response-code>J</avs-response-code>
    <card-holder-info>
        <first-name>test first name</first-name>
        <last-name>test last name</last-name>
        <country>us</country>
        <zip>02453</zip>
    </card-holder-info>
    <vaulted-shopper-id>24122703</vaulted-shopper-id>
    <credit-card>
        <card-last-four-digits>0004</card-last-four-digits>
        <card-type>VISA</card-type>
        <card-sub-type>CREDIT</card-sub-type>
        <card-category>CORPORATE T&#x26;E</card-category>
        <bin-category>COMMERCIAL</bin-category>
        <card-regulated>N</card-regulated>
        <issuing-country-code>us</issuing-country-code>
    </credit-card>
    <level-3-data>
        <customer-reference-number>1234A</customer-reference-number>
        <sales-tax-amount>0.6</sales-tax-amount>
        <freight-amount>0</freight-amount>
        <duty-amount>0</duty-amount>
        <destination-zip-code>12345</destination-zip-code>
        <destination-country-code>us</destination-country-code>
        <ship-from-zip-code>12345</ship-from-zip-code>
        <discount-amount>0</discount-amount>
        <tax-amount>0.6</tax-amount>
        <tax-rate>6</tax-rate>
        <transaction-processed-with-l3d-supported-acquirer>true</transaction-processed-with-l3d-supported-acquirer>
        <level-3-data-item>
            <line-item-total>10.6</line-item-total>
            <commodity-code>123</commodity-code>
            <description>test_desc</description>
            <discount-amount>0</discount-amount>
            <discount-indicator>Y</discount-indicator>
            <gross-net-indicator>Y</gross-net-indicator>
            <product-code>test_code</product-code>
            <item-quantity>1</item-quantity>
            <tax-amount>0.6</tax-amount>
            <tax-rate>6</tax-rate>
            <unit-cost>10</unit-cost>
            <unit-of-measure>usd</unit-of-measure>
        </level-3-data-item>
    </level-3-data>
    <processing-info>
        <processing-status>success</processing-status>
        <cvv-response-code>NR</cvv-response-code>
        <avs-response-code-zip>U</avs-response-code-zip>
        <avs-response-code-address>U</avs-response-code-address>
        <avs-response-code-name>U</avs-response-code-name>
    </processing-info>
    <fraud-result-info>
        <device-data-collector>N</device-data-collector>
    </fraud-result-info>
</card-transaction>

Sample Auth Only request and response

<card-transaction xmlns="http://ws.plimus.com">
  <card-transaction-type>AUTH_ONLY</card-transaction-type>
  <soft-descriptor>DescTest</soft-descriptor>
  <amount>10.60</amount>
  <currency>USD</currency>
  <card-holder-info>
    <first-name>test first name</first-name>
    <last-name>test last name</last-name>
    <zip>02453</zip>
    <country>us</country>
  </card-holder-info>
  <credit-card>
    <card-number>4005 5192 0000 0004</card-number>
    <security-code>111</security-code>
    <expiration-month>09</expiration-month>
    <expiration-year>2023</expiration-year>
  </credit-card>
  <level-3-data>
    <customer-reference-number>1234A</customer-reference-number>
    <sales-tax-amount>0.6</sales-tax-amount>
    <freight-amount>0</freight-amount>
    <duty-amount>0</duty-amount>
    <destination-zip-code>12345</destination-zip-code>
    <destination-country-code>us</destination-country-code>
    <ship-from-zip-code>12345</ship-from-zip-code>
    <discount-amount>0</discount-amount>
    <tax-amount>0.6</tax-amount>
    <tax-rate>6.0</tax-rate>
    <level-3-data-item>
      <line-item-total>10.60</line-item-total>
      <description>test_desc</description>
      <discount-amount>0</discount-amount>
      <product-code>test_code</product-code>
      <item-quantity>1</item-quantity>
      <tax-amount>0.60</tax-amount>
      <tax-rate>6.0</tax-rate>
      <unit-of-measure>usd</unit-of-measure>
      <commodity-code>123</commodity-code>
      <discount-indicator>Y</discount-indicator>
      <gross-net-indicator>Y</gross-net-indicator>
      <unit-cost>10.00</unit-cost>
    </level-3-data-item>
  </level-3-data>
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
  <card-transaction-type>AUTH_ONLY</card-transaction-type>
  <transaction-id>38550322</transaction-id>
  <recurring-transaction>ECOMMERCE</recurring-transaction>
  <soft-descriptor>BLS&#x2a;DescTest</soft-descriptor>
  <amount>10.60</amount>
  <usd-amount>10.60</usd-amount>
  <currency>USD</currency>
  <avs-response-code>J</avs-response-code>
  <card-holder-info>
    <first-name>test first name</first-name>
    <last-name>test last name</last-name>
    <country>us</country>
    <zip>02453</zip>
  </card-holder-info>
  <vaulted-shopper-id>19590366</vaulted-shopper-id>
  <credit-card>
    <card-last-four-digits>0004</card-last-four-digits>
    <card-type>VISA</card-type>
    <bin-category>CONSUMER</bin-category>
    <bin-number>400551</bin-number>
    <expiration-month>09</expiration-month>
    <expiration-year>2023</expiration-year>
  </credit-card>
  <level-3-data>
    <customer-reference-number>1234A</customer-reference-number>
    <sales-tax-amount>0.6</sales-tax-amount>
    <freight-amount>0</freight-amount>
    <duty-amount>0</duty-amount>
    <destination-zip-code>12345</destination-zip-code>
    <destination-country-code>us</destination-country-code>
    <ship-from-zip-code>12345</ship-from-zip-code>
    <discount-amount>0</discount-amount>
    <tax-amount>0.6</tax-amount>
    <tax-rate>6</tax-rate>
    <transaction-processed-with-l3d-supported-acquirer>true</transaction-processed-with-l3d-supported-acquirer>
    <level-3-data-item>
      <line-item-total>10.6</line-item-total>
      <commodity-code>123</commodity-code>
      <description>test_desc</description>
      <discount-amount>0</discount-amount>
      <discount-indicator>Y</discount-indicator>
      <gross-net-indicator>Y</gross-net-indicator>
      <product-code>test_code</product-code>
      <item-quantity>1</item-quantity>
      <tax-amount>0.6</tax-amount>
      <tax-rate>6</tax-rate>
      <unit-cost>10</unit-cost>
      <unit-of-measure>usd</unit-of-measure>
    </level-3-data-item>
  </level-3-data>
  <network-transaction-info>
    <original-network-transaction-id>751005562553365</original-network-transaction-id>
    <network-transaction-id>751005562553365</network-transaction-id>
  </network-transaction-info>
  <processing-info>
    <processing-status>success</processing-status>
    <cvv-response-code>NR</cvv-response-code>
    <authorization-code>092476</authorization-code>
    <avs-response-code-zip>U</avs-response-code-zip>
    <avs-response-code-address>U</avs-response-code-address>
    <avs-response-code-name>U</avs-response-code-name>
    <network-transaction-id>751005562553365</network-transaction-id>
  </processing-info>
  <fraud-result-info>
    <device-data-collector>N</device-data-collector>
  </fraud-result-info>
</card-transaction>

Sample Capture request and response

<card-transaction xmlns="http://ws.plimus.com">
  <card-transaction-type>CAPTURE</card-transaction-type>
  <transaction-id>38550320</transaction-id>
  <level-3-data>
    <customer-reference-number>1234A</customer-reference-number>
    <sales-tax-amount>0.6</sales-tax-amount>
    <freight-amount>0</freight-amount>
    <duty-amount>0</duty-amount>
    <destination-zip-code>12345</destination-zip-code>
    <destination-country-code>us</destination-country-code>
    <ship-from-zip-code>12345</ship-from-zip-code>
    <discount-amount>0</discount-amount>
    <tax-amount>0.6</tax-amount>
    <tax-rate>6.0</tax-rate>
    <level-3-data-item>
      <line-item-total>10.60</line-item-total>
      <description>test_desc</description>
      <discount-amount>0</discount-amount>
      <product-code>test_code</product-code>
      <item-quantity>1</item-quantity>
      <tax-amount>0.60</tax-amount>
      <tax-rate>6.0</tax-rate>
      <unit-of-measure>usd</unit-of-measure>
      <commodity-code>123</commodity-code>
      <discount-indicator>Y</discount-indicator>
      <gross-net-indicator>Y</gross-net-indicator>
      <unit-cost>10.00</unit-cost>
    </level-3-data-item>
  </level-3-data>
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
  <card-transaction-type>CAPTURE</card-transaction-type>
  <transaction-id>38550320</transaction-id>
  <soft-descriptor>BLS&#x2a;BS</soft-descriptor>
  <amount>20.00</amount>
  <usd-amount>20.00</usd-amount>
  <open-to-capture>0</open-to-capture>
  <currency>USD</currency>
  <transaction-approval-date>01/05/2021</transaction-approval-date>
  <transaction-approval-time>07:27:48</transaction-approval-time>
  <card-holder-info>
    <first-name>John</first-name>
    <last-name>Blue</last-name>
    <email>test&#x40;bluesnap. com</email>
    <country>us</country>
  </card-holder-info>
  <vaulted-shopper-id>19590364</vaulted-shopper-id>
  <credit-card>
    <card-last-four-digits>1111</card-last-four-digits>
    <card-type>VISA</card-type>
    <card-sub-type>CREDIT</card-sub-type>
    <bin-category>CONSUMER</bin-category>
    <bin-number>411111</bin-number>
    <card-regulated>Y</card-regulated>
    <issuing-bank>JPMORGAN CHASE BANK, N.A.</issuing-bank>
    <expiration-month>7</expiration-month>
    <expiration-year>2023</expiration-year>
    <issuing-country-code>us</issuing-country-code>
  </credit-card>
  <level-3-data>
    <customer-reference-number>1234A</customer-reference-number>
    <sales-tax-amount>0.6</sales-tax-amount>
    <freight-amount>0</freight-amount>
    <duty-amount>0</duty-amount>
    <destination-zip-code>12345</destination-zip-code>
    <destination-country-code>us</destination-country-code>
    <ship-from-zip-code>12345</ship-from-zip-code>
    <discount-amount>0</discount-amount>
    <tax-amount>0.6</tax-amount>
    <tax-rate>6.0</tax-rate>
    <transaction-processed-with-l3d-supported-acquirer>true</transaction-processed-with-l3d-supported-acquirer>
    <level-3-data-item>
      <line-item-total>10.60</line-item-total>
      <commodity-code>123</commodity-code>
      <description>test_desc</description>
      <discount-amount>0</discount-amount>
      <discount-indicator>Y</discount-indicator>
      <gross-net-indicator>Y</gross-net-indicator>
      <product-code>test_code</product-code>
      <item-quantity>1</item-quantity>
      <tax-amount>0.60</tax-amount>
      <tax-rate>6.0</tax-rate>
      <unit-cost>10.00</unit-cost>
      <unit-of-measure>usd</unit-of-measure>
    </level-3-data-item>
  </level-3-data>
  <network-transaction-info>
    <original-network-transaction-id>751005553983001</original-network-transaction-id>
    <network-transaction-id>751005553983001</network-transaction-id>
  </network-transaction-info>
  <processing-info>
    <processing-status>SUCCESS</processing-status>
    <cvv-response-code>MA</cvv-response-code>
    <authorization-code>436908</authorization-code>
    <avs-response-code-zip>U</avs-response-code-zip>
    <avs-response-code-address>U</avs-response-code-address>
    <avs-response-code-name>U</avs-response-code-name>
    <network-transaction-id>751005553983001</network-transaction-id>
  </processing-info>
  <fraud-result-info>
    <device-data-collector>N</device-data-collector>
  </fraud-result-info>
</card-transaction>

Test Cards

The following cards are used for testing of Level 2/3 Data:

  • Visa: 4111111111111111    Exp: 02/2023
  • MasterCard: 5199701234567892    Exp: 02/2023
  • Amex (L2 w/ TAA fields): 340000000000009    Exp: 05/2023

Back to Top