Defines individual items in a transaction, including quantity, cost, and tax status.

Transaction Details - Itemization Definition

Product Itemization & Display

Variable Requirement Type Possible Values / Example Description Notes
pd_display_items Optional boolean yes If set to yes, displays the order contents on the payment page and in email confirmations to the customer and merchant. Defaults to hidden if not provided.
pt_item_identifier_# Optional string SKU12345 SKU or model number of the item. # represents the item sequence number (1, 2, 3…).
pt_item_description_# Optional string Red T-shirt, Size M Description of the item. Useful for customer confirmation and reporting.
pt_item_cost_# Optional string 123.45 Cost of the item. Must be numeric 1234.56 format. 1
pt_item_quantity_# Optional string 1 Quantity of the item purchased. Defaults to 1 if not provided.
pt_item_is_taxable_# Optional string yes Flags whether the item is taxable. If omitted, items are assumed taxable.

⚠️ Numbering Rule for Itemization

  1. Each item must use a sequential number starting at 1.
  2. All fields for an item are grouped by the same number:
pt_item_identifier_1
pt_item_description_1
pt_item_cost_1
pt_item_quantity_1
pt_item_is_taxable_1

pt_item_identifier_2
pt_item_description_2
pt_item_cost_2
pt_item_quantity_2
pt_item_is_taxable_2
  1. Missing sequences may cause fields to be ignored or misaligned in reports.

⚠️ Amount Format Rule

  1. Amounts must be numeric only in the format 1234.56. No currency symbols, commas, or other characters are allowed. Exactly two decimal places are required. ↩︎