Covers transaction totals, taxes, fees, and currency formatting.

Transaction Details - Amount

Currency / Transaction Amount

Variable Requirement Type Possible Values / Example Description Notes
pt_currency Optional string USD Three-character ISO currency code. Must follow ISO 4217 format (e.g., USD, EUR).
pd_currency_symbol Optional string $ Currency symbol used for display. UI-only field; does not affect processing.
pt_subtotal Optional string 123.45 Transaction subtotal before taxes, fees, and shipping. Must follow numeric format 1234.56 only. 1
pt_convenience_fee_amount Optional string 3.95 Convenience fee applied to transaction. Included in total calculation if provided. 1
pt_shipping_amount Optional string 2.00 Flat shipping fee for the order. Applies to full order total. 1
pt_handling_amount Optional string 1.00 Flat handling fee for the order. Added before final transaction total. 1
pt_tax_amount Optional string 12.34 Sales tax amount (Level 2 processing). Defaults to 0.00 if not provided. 1
pt_tax_rate Optional string 0.0825 Sales tax rate. Example: 0.0825 = 8.25%.
pt_transaction_amount Mandatory string 1234.56 Total amount charged for the transaction. Must include all fees, tax, and shipping. 1
pt_pre_transaction_balance Optional string 1234.56 Account balance before transaction. Used for reporting and reconciliation. 1

⚠️ Formatting Rule (Applies to All Amount Fields)

  1. All monetary values must be numeric only in the format 1234.56. Do not include currency symbols, commas, or formatting. Exactly two decimal places are required. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎