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 name | Description | Required | Length | Data type |
---|---|---|---|---|
ssl_customer_vat_number | Customer VAT Number The identification number assigned by the VAT authority to the buying company. | Optional | 13 | alphanumeric |
ssl_discount_amount | Discount Amount The discount amount for the entire transaction (order). | Optional | 11 | numeric |
ssl_duty_amount | Duty Amount The total charges for any import or export duties included in the transaction. | Optional | 11 | numeric |
ssl_freight_tax_amount | VAT or Tax Amount VAT or tax applied to the freight or shipping amount. | Optional | 12 | numeric |
ssl_level3_indicator | Level 3 Indicator Valid values:
| Required | 1 | alphanumeric |
ssl_line_Item_alternative_tax | Alternate Tax ID The alternate tax identifier description for the line item. | Optional | 12 | numeric |
ssl_line_Item_commodity_code | Line Item Commodity Code The commodity code used to classify the line item. | Optional | 12 | alphanumeric |
ssl_line_item_description | Line Item Description | Optional | 35 | alphanumeric |
ssl_line_item_discount_amount | Discount Amount The discount amount for the entire line item. | Optional | 11 | numeric |
ssl_line_Item_discount_indicator | Line Item Discount Indicator Indicates whether the line item is discounted. Valid values:
| Optional | 1 | alphanumeric |
ssl_line_Item_extended_total | Line Item Extended Amount The total cost of the line item for the detail record. Computation Rule: Quantity x Unit Price | Optional | 9 | numeric |
ssl_line_Item_product_code | Line Item Product Code The part or catalog number of the line item. | Optional | 12 | alphanumeric |
ssl_line_Item_quantity | Line Item Quantity The number of purchased units for the line item. | Optional | 12 | numeric |
ssl_line_Item_unit_cost | Line Item Unit Cost The cost of each purchased unit for the line item. | Optional | 12 | numeric |
ssl_line_Item_unit_of_measure | Line Item Measurement Code The unit of measure that each line item is purchased in. | Optional | 3 | alphanumeric |
ssl_line_Item_tax_amount | Line Item Tax Amount The tax amount for each purchased unit. | Optional | 12 | numeric |
ssl_line_Item_tax_indicator | Line Item Tax Indicator Indicates whether the line item is taxable. Valid values:
| Optional | 1 | alphanumeric |
ssl_line_Item_tax_rate | Line Item Tax Rate | Optional | 4 | numeric |
ssl_line_Item_tax_type | Line Item Tax Type The type of tax applied to the line item. | Optional | 4 | alphanumeric |
ssl_line_Item_total | Line Item Total Amount | Optional | 12 | numeric |
ssl_merchant_vat_number | Merchant VAT Number The identification number assigned by the taxing authority to the merchant. | Optional | 20 | alphanumeric |
ssl_national_tax_indicator | National Tax Indicator Valid values: Visa
| Optional | 1 | alphanumeric |
ssl_national_tax_amount | National or VAT Amount | Optional | 11 | numeric |
ssl_order_date | Order Date Date when the merchant received the order. Format: YYMMDD | Optional | 6 | numeric |
ssl_other_fees | Other Fees | Optional | 12 | numeric |
ssl_other_tax | Other Tax Amount | Optional | 12 | numeric |
ssl_salestax_indicator | Sales Tax Indicator Whether tax is included on a transaction. This field is required for Level 3 transactions. Valid values:
| Conditional | - | alphanumeric |
ssl_ship_from_postal_code | ZIP Code ZIP or postal code of the originating address. | Optional | 9 | alphanumeric |
ssl_shipping_amount | Freight or Shipping Amount | Optional | 11 | numeric |
ssl_shipping_company | Shipping Company Name | Optional | 50 | alphanumeric |
ssl_ship_to_zip | ZIP Code ZIP or postal code of the destination address. | Optional | 9 | alphanumeric |
ssl_ship_to_country | Country Code Country ISO code of the destination address. | Optional | 3 | alphanumeric |
ssl_summary_commodity_code | Summary Commodity Code Indicates whether Level 3 data is in the line item detail. | Optional | 4 | alphanumeric |
ssl_tracking_number | Shipping Tracking Number | Optional | 25 | alphanumeric |
ssl_summary_commodity_code | Summary Commodity Code Indicates whether Level 3 data is in the line item detail. | Optional | 4 | alphanumeric |
ssl_vat_invoice_number | VAT Invoice Number | Optional | 15 | alphanumeric |
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>