Supporting level 2 & 3 Transactions for Payments Using Paypal

This document explains how Level 2 and Level 3 processing for Advanced PayPal payment transactions has been added to the Aptify system. We have improved the Authorization and Capture requests by adding extra data fields, following PayPal's guidelines. These fields are included based on the type of card used in the transaction.

This update allows the Aptify system to handle more detailed transaction data for certain card types. This helps in getting better rates and meeting the requirements set by major card networks.

For more details, refer to the PayPal Level 2 and Level 3 document.

Configuration details

The following attributes have been added to web.config file for Level 2 and Level 3 processing for Advanced PayPal payment transactions within the Aptify system

<add key="Aptify.Applications.Payments.Level2.CardTypes" value="VISA,MASTERCARD, AMEX" />
<add key="Aptify.Applications.Payments.Level3.CardTypes" value="VISA,MASTERCARD" />

Note: Replace the card type in the above attribute based on the card used.

According to PayPal, "Visa and Mastercard offer Levels 2 and 3 processing. American Express offers Level 2, and Discover offers only Level 1 processing."

Level 2 Implementation details

Below are the fields added to Authorization and Capture Requests:

• tax_total:  
  • currency_code: This is the currency code for an order.
  • values: This is the total calculated tax amount for an order.

Note: Some other fields mentioned in "PayPal Level 2 and Level 3" document are currently not applicable for Aptify.

Level 3 Implementation

Below are the fields added to Authorization and Capture Requests.

• shipping_amount
  • currency_code: This is the currency code for an order.
  • value: Shipping charges
• duty_amount
  • currency_code: This is the currency code for an order.
  • value: Shipping and handling charges. 
• discount_amount
  • currency_code: This is the currency code for an order.
  • value: Discount amount on the order
• shipping_address
  • address_line_1
  • address_line_2
  • admin_area_2
  • admin_area_1
  • postal_code
  • country_code
• line_items (List)
  • name: Name of a product.
  • unit_amount
    • currency_code: This is the currency code for an orderline.
    • value: Price of single product
  • quantity
  • description
  • discount_amount
    • currency_code: This is the currency code for an orderline.
    • value: Total discount on a product.
  • total_amount
    • currency_code: This is the currency code for an order.
    • value: Total value of product in terms of quantity. 

Note: Some other fields mentioned in "PayPal Level 2 and Level 3" document are currently not applicable for Aptify.

Conditional Logic in Code

The inclusion of Level 2 and Level 3 fields is controlled by logic that checks the card type against the configured values in web.config. Based on this, the system appends the appropriate fields to the request payload.