Level III

Level 3 credit card processing requires a great extent of data for performing transactions with government or corporate sectors. Level 3 option is available for Converge terminals and is enabled as a part of the terminal setup. If you would like to enable level 3 options for your site, please contact Elavon Software Technical Support.

In this section:

Supported Transaction Types

Level 3 options are available for the following transaction types.

  • Credit Card Sale - ccsale
  • Credit Card Auth Only - ccauthonly

Level 3 Fields

Level 3 transactions involve the following fields. These fields are only available for terminals with Level 3 enabled. A transaction can have up to 998 products (product), which are nested within the Line Item Products (LineItemProducts) parameter.

Field nameDescriptionRequiredLengthData type
ssl_customer_vat_numberCustomer VAT Number
The identification number assigned by the VAT authority to the buying company.
Optional13alphanumeric
ssl_discount_amountDiscount Amount
The discount amount for the entire transaction (order).
Optional11numeric
ssl_duty_amountDuty Amount
The total charges for any import or export duties included in the transaction.
Optional11numeric
ssl_freight_tax_amountVAT or Tax Amount
VAT or tax applied to the freight or shipping amount.
Optional12numeric
ssl_level3_indicatorLevel 3 Indicator
Valid values:
  • Y - Level 3 transaction (send Level 3 data to issuer)
  • N - Only save data locally (do not send Level 3 data to issuer)
Required1alphanumeric
ssl_line_Item_alternative_taxAlternate Tax ID
The alternate tax identifier description for the line item.
Optional12numeric
ssl_line_Item_commodity_codeLine Item Commodity Code
The commodity code used to classify the line item.
Optional12alphanumeric
ssl_line_item_descriptionLine Item DescriptionOptional35alphanumeric
ssl_line_item_discount_amountDiscount Amount
The discount amount for the entire line item.
Optional11numeric
ssl_line_Item_discount_indicatorLine Item Discount Indicator
Indicates whether the line item is discounted.
Valid values:
  • Y - Item amount is discounted
  • N - Item amount is not discounted
Optional1alphanumeric
ssl_line_Item_extended_totalLine Item Extended Amount
The total cost of the line item for the detail record.
Computation Rule: Quantity x Unit Price
Optional9numeric
ssl_line_Item_product_codeLine Item Product Code
The part or catalog number of the line item.
Optional12alphanumeric
ssl_line_Item_quantityLine Item Quantity
The number of purchased units for the line item.
Optional12numeric
ssl_line_Item_unit_costLine Item Unit Cost
The cost of each purchased unit for the line item.
Optional12numeric
ssl_line_Item_unit_of_measureLine Item Measurement Code
The unit of measure that each line item is purchased in.
Optional3alphanumeric
ssl_line_Item_tax_amountLine Item Tax Amount
The tax amount for each purchased unit.
Optional12numeric
ssl_line_Item_tax_indicatorLine Item Tax Indicator
Indicates whether the line item is taxable.
Valid values:
  • Y - Item amount is taxable
  • N - Item amount is not taxable
Optional1alphanumeric
ssl_line_Item_tax_rateLine Item Tax RateOptional4numeric
ssl_line_Item_tax_typeLine Item Tax Type
The type of tax applied to the line item.
Optional4alphanumeric
ssl_line_Item_totalLine Item Total AmountOptional12numeric
ssl_merchant_vat_numberMerchant VAT Number
The identification number assigned by the taxing authority to the merchant.
Optional20alphanumeric
ssl_national_tax_indicatorNational Tax Indicator
Valid values:
Visa
  • 0 - Tax not included in total purchase amount
  • 1 - Tax included in total purchase amount
MasterCard
  • Y - Tax included in total purchase amount
  • N - Transaction not subject to tax
  • 0 or Space - Tax information unknown
Optional1alphanumeric
ssl_national_tax_amountNational or VAT AmountOptional11numeric
ssl_order_dateOrder Date
Date when the merchant received the order.
Format: YYMMDD
Optional6numeric
ssl_other_feesOther FeesOptional12numeric
ssl_other_taxOther Tax AmountOptional12numeric
ssl_salestax_indicatorSales Tax Indicator
Whether tax is included on a transaction. This field is required for Level 3 transactions.
Valid values:
  • Visa
    • 0 - Tax Exempted Sale for Visa (card acceptor has the ability to provide tax amount, but goods/services were not taxable)
    • 1 - Sales Tax Included for Visa
    • 2 - Transaction not subject to Tax for Visa
  • MasterCard
    • Y - Sales Tax Included for MasterCard
    • N - Tax Exempted Sale for MasterCard (card acceptor has the ability to provide tax amount, but goods/services were not taxable)
Conditional-alphanumeric
ssl_ship_from_postal_codeZIP Code
ZIP or postal code of the originating address.
Optional9alphanumeric
ssl_shipping_amountFreight or Shipping AmountOptional11numeric
ssl_shipping_companyShipping Company NameOptional50alphanumeric
ssl_ship_to_zipZIP Code
ZIP or postal code of the destination address.
Optional9alphanumeric
ssl_ship_to_countryCountry Code
Country ISO code of the destination address.
Optional3alphanumeric
ssl_summary_commodity_codeSummary Commodity Code
Indicates whether Level 3 data is in the line item detail.
Optional4alphanumeric
ssl_tracking_numberShipping Tracking NumberOptional25alphanumeric
ssl_summary_commodity_codeSummary Commodity Code
Indicates whether Level 3 data is in the line item detail.
Optional4alphanumeric
ssl_vat_invoice_numberVAT Invoice NumberOptional15alphanumeric

Example

Sale with Level 3 Data

Request

xmldata=
<txn>
    <ssl_merchant_id>my_merchant_id</ssl_merchant_id>
    <ssl_user_id>my_user_id</ssl_user_id>
    <ssl_pin>my_pin</ssl_pin>
    <ssl_transaction_type>CCSALE</ssl_transaction_type>
    <ssl_card_number>4388020000083560</ssl_card_number>
    <ssl_exp_date>1222</ssl_exp_date>
    <ssl_amount>41.00</ssl_amount>
    <ssl_cvv2cvc2_indicator>1</ssl_cvv2cvc2_indicator>
    <ssl_cvv2cvc2>123</ssl_cvv2cvc2>
    <ssl_bin_override>1</ssl_bin_override>
    <ssl_salestax>3</ssl_salestax>
    <ssl_customer_code>ADH2007</ssl_customer_code>
    <ssl_invoice_number>13012016</ssl_invoice_number>

    <!--System fields, used in Level3 Clearing File -->
    <ssl_ship_to_zip>L4W 2C8</ssl_ship_to_zip>
    <ssl_ship_to_country>CAN</ssl_ship_to_country>

    <!--Level3 fields -->
    <ssl_ship_from_postal_code>L9T 7D6</ssl_ship_from_postal_code>
    <ssl_discount_amount>0</ssl_discount_amount>
    <ssl_duty_amount>0</ssl_duty_amount>
    <ssl_shipping_amount>10</ssl_shipping_amount>
    <ssl_national_tax_indicator>1</ssl_national_tax_indicator>
    <ssl_national_tax_amount>4</ssl_national_tax_amount>
    <ssl_order_date>06/14/2019</ssl_order_date>
    <ssl_other_tax>0</ssl_other_tax>
    <ssl_summary_commodity_code>444</ssl_summary_commodity_code>
    <ssl_merchant_vat_number>222</ssl_merchant_vat_number>
    <ssl_customer_vat_number>333</ssl_customer_vat_number>
    <ssl_freight_tax_amount>1</ssl_freight_tax_amount>
    <ssl_freight_tax_rate>10</ssl_freight_tax_rate>
    <ssl_vat_invoice_number>224</ssl_vat_invoice_number>

    <!--Indicator to include the Level3 data in Clearing File -->
    <ssl_level3_indicator>Y</ssl_level3_indicator>

    <!--Level3 fields, not used in Clearing File -->
    <ssl_tracking_number>123456789</ssl_tracking_number>
    <ssl_shipping_company>Elavon</ssl_shipping_company>
    <ssl_other_fees>0</ssl_other_fees>

    <LineItemProducts>
    <product>
        <ssl_line_Item_description>First product</ssl_line_Item_description>
        <ssl_line_Item_product_code>36272881</ssl_line_Item_product_code>
        <ssl_line_Item_commodity_code>10222201</ssl_line_Item_commodity_code>
        <ssl_line_Item_quantity>4</ssl_line_Item_quantity>
        <ssl_line_Item_unit_of_measure>EA</ssl_line_Item_unit_of_measure>
        <ssl_line_Item_unit_cost>5.00</ssl_line_Item_unit_cost>
        <ssl_line_Item_discount_indicator>1</ssl_line_Item_discount_indicator>
        <ssl_line_Item_discount_amount>2.00</ssl_line_Item_discount_amount>
        <ssl_line_Item_tax_Indicator>1</ssl_line_Item_tax_Indicator>
        <ssl_line_Item_tax_rate>10</ssl_line_Item_tax_rate>
        <ssl_line_Item_tax_amount>2.00</ssl_line_Item_tax_amount>
        <ssl_line_Item_tax_type>1</ssl_line_Item_tax_type>
        <ssl_line_Item_extended_total>20</ssl_line_Item_extended_total>
        <ssl_line_Item_total>18</ssl_line_Item_total>
        <ssl_line_Item_alternative_tax>GST</ssl_line_Item_alternative_tax>
    </product>
    <product>
        <ssl_line_Item_description>Second product</ssl_line_Item_description>
        <ssl_line_Item_product_code>23384</ssl_line_Item_product_code>
        <ssl_line_Item_commodity_code>10302345</ssl_line_Item_commodity_code>
        <ssl_line_Item_quantity>3</ssl_line_Item_quantity>
        <ssl_line_Item_unit_of_measure>EA</ssl_line_Item_unit_of_measure>
        <ssl_line_Item_unit_cost>2.00</ssl_line_Item_unit_cost>
        <ssl_line_Item_discount_indicator>1</ssl_line_Item_discount_indicator>
        <ssl_line_Item_discount_amount>1.00</ssl_line_Item_discount_amount>
        <ssl_line_Item_tax_Indicator>2</ssl_line_Item_tax_Indicator>
        <ssl_line_Item_tax_rate>10</ssl_line_Item_tax_rate>
        <ssl_line_Item_tax_amount>0.60</ssl_line_Item_tax_amount>
        <ssl_line_Item_tax_type>2</ssl_line_Item_tax_type>
        <ssl_line_Item_extended_total>6</ssl_line_Item_extended_total>
        <ssl_line_Item_total>5</ssl_line_Item_total>
        <ssl_line_Item_alternative_tax>PST</ssl_line_Item_alternative_tax>
    </product>
    </LineItemProducts>
</txn>

Response

<txn>
    <ssl_shipping_amount>10</ssl_shipping_amount>
    <ssl_issuer_response>00</ssl_issuer_response>
    <ssl_card_number>43**********3560</ssl_card_number>
    <ssl_departure_date/>
    <ssl_oar_data>010012088812142105490000048727100000000000062633234821120888</ssl_oar_data>
    <ssl_duty_amount>0</ssl_duty_amount>
    <ssl_result>0</ssl_result>
    <ssl_txn_id>141222O24-3CBA2655-3F71-4220-969E-855C3E78B818</ssl_txn_id>
    <ssl_avs_response> </ssl_avs_response>
    <ssl_approval_code>062633</ssl_approval_code>
    <ssl_amount>41.00</ssl_amount>
    <ssl_txn_time>12/14/2022 04:05:49 PM</ssl_txn_time>
    <ssl_exp_date>1222</ssl_exp_date>
    <ssl_card_short_description>VISA</ssl_card_short_description>
    <ssl_completion_date/>
    <ssl_get_token>N</ssl_get_token>
    <ssl_customer_code>ADH2007</ssl_customer_code>
    <ssl_card_type>CREDITCARD</ssl_card_type>
    <ssl_freight_tax_amount>1</ssl_freight_tax_amount>
    <ssl_transaction_type>SALE</ssl_transaction_type>
    <ssl_national_tax_amount>4</ssl_national_tax_amount>
    <ssl_salestax>3.00</ssl_salestax>
    <ssl_freight_tax_rate>10</ssl_freight_tax_rate>
    <ssl_account_balance>0.00</ssl_account_balance>
    <ssl_ps2000_data>A000000000000000 A</ssl_ps2000_data>
    <ssl_result_message>APPROVAL</ssl_result_message>
    <ssl_invoice_number>13012016</ssl_invoice_number>
    <ssl_cvv2_response/>
    <ssl_partner_app_id>01</ssl_partner_app_id>
</txn>