Payment TerminalsHow to Configure L3 Item Information for Your Merchants' Payment Terminals

How to Configure L3 Item Information for Your Merchants’ Payment Terminals

iPOSpays allows ISOs to configure L3 Item Information for their merchants’ payment terminals. These settings enable merchants to capture additional transaction details, including Purchase Order Number, Customer VAT Reg Number, Purchase Identifier, and VAT Inv Ref Number, to support Level 3 transaction data requirements. This document explains how to configure L3 Item Information for a merchant’s TPN in the iPOSpays portal.


Feature Compatibility

  • Minimum Required POS Build:

    • Purchase Order Number: 10084
    • Other L3 fields: 10157
  • Supported Platform:

    • Payment Terminals (POS)
    • CloudPOS

Access the L3 Item Information Settings

  1. Log in to the iPOSpays portal using your ISO credentials.
  2. Go to S.T.E.A.M → Edit Parameters.
  3. Use the search box to locate and select the required merchant TPN.
  4. Click Edit Parameter.
  1. Go to the Transaction tab.
  1. Scroll down to L3 Item Information and configure the required L3 item information by clicking the Enable or Disable option.

Configure L3 Item Information

The L3 Item Information section provides the following parameters:

1. Purchase Order Number

Specifies whether Purchase Order Number functionality is enabled for the selected TPN. When enabled, transactions can be tagged with a purchase order number to track and manage procurement transactions.

Maximum Character Limit: The Purchase Order Number can contain up to 15 characters.

  1. Click Enable under Purchase Order Number.
  • Tag Label

Specifies the label displayed for the purchase order number on the transaction screen.

  1. Enter the required label in the Tag Label field.

Example: Purchase Order or PO Number.

  • Requirement Level

Specifies whether entering a purchase order number is required during the transaction.

Select the required option from the Requirement Level dropdown:

  • Mandatory – Requires the purchase order number to be entered.
  • Optional – Allows the user to enter a purchase order number, but it is not required.
  • Supported Transaction Types

The Purchase Order Number is supported for:

  • POS Terminals – Card-Not-Present transactions
  • CloudPOS
    1. Send Payment Link
    2. Pay Now
    3. PIN Pad

The PO Number field is displayed on the customer-facing payment page opened from the Send Payment Link, where the customer can enter their purchase order number before completing the transaction.


2. Customer VAT Reg Number

Specifies whether Customer VAT (Value Added Tax) Reg Number functionality is enabled for the selected TPN. When enabled, transactions can include the customer’s VAT registration number as part of the L3 transaction information.

Maximum Character Limit: The Customer VAT Reg Number can contain up to 13 characters.

  1. Click Enable under Customer VAT Reg Number.
  • Tag Label

Specifies the label displayed for the customer VAT registration number on the transaction screen.

  1. Enter the required label in the Tag Label field.

Example: CVRN or VAT Reg Number.

  • Requirement Level

Specifies whether entering a customer VAT registration number is required during the transaction.

  1. Select the required option from the Requirement Level dropdown:

    • Mandatory – Requires the customer VAT registration number to be entered.
    • Optional – Allows the user to enter a customer VAT registration number but does not require it.
  • Supported Transaction Types

The Customer VAT Reg Number is supported for:

  • POS Terminals – Send Payment Link
  • CloudPOS – Send Payment Link

The Customer VAT Reg Number field is displayed on the payment page opened from the payment link, where the customer can enter their VAT registration number before completing the transaction.


3. Purchase Identifier

Specifies whether Purchase Identifier functionality is enabled for the selected TPN. When enabled, transactions can include a purchase identifier to help identify and track purchase-related transactions.

Maximum Character Limit: The Purchase Identifier can contain up to 25 characters.

  1. Click Enable under Purchase Identifier.
  • Tag Label

Specifies the label displayed for the purchase identifier on the transaction screen.

  1. Enter the required label in the Tag Label field.

Example: PID or Purchase ID.

  • Requirement Level

Specifies whether entering a purchase identifier is required during the transaction.

  1. Select the required option from the Requirement Level dropdown:

    • Mandatory – Requires the purchase identifier to be entered.
    • Optional – Allows the user to enter a purchase identifier, but it is not required.
  • Supported Transaction Types

The Purchase Identifier is supported for the following CloudPOS payment types:

  • Send Payment Link
  • Pay Now
  • Pinpad

The Purchase Identifier (PID) is automatically generated and populated for these payment types.


4. VAT Inv Ref Number

Specifies whether VAT (Value Added Tax) Inv Ref Number functionality is enabled for the selected TPN. When enabled, transactions can include a VAT invoice reference number as part of the L3 transaction information.

Maximum Character Limit: The VAT Inv Ref Number can contain up to 15 characters.

  1. Click Enable under VAT Inv Ref Number.
  • Tag Label

Specifies the label displayed for the VAT invoice reference number on the transaction screen.

  1. Enter the required label in the Tag Label field.

Example: VIRN or VAT Invoice Ref.

  • Requirement Level

Specifies whether entering a VAT invoice reference number is required during the transaction.

  1. Select the required option from the Requirement Level dropdown:

    • Mandatory – Requires the VAT invoice reference number to be entered.
    • Optional – Allows the user to enter a VAT invoice reference number but does not require it.
  • Supported Transaction Types

The VAT Invoice Reference Number is supported for the following CloudPOS payment types:

  • Send Payment Link
  • Pay Now
  • Pinpad

Save the L3 Item Information Settings

After configuring the required L3 Item Information parameters:

  1. Click Save to apply the changes to the selected TPN.

OR

  1. Click Save As Template to save the configured parameters as a template for future use.

Perform a parameter update on the merchant’s payment terminal for the updated L3 Item Information settings to take effect.