TransactionItem Subobject
Web Session Object
Transaction Object
Token Object
Season Set Object
Refund Object
RatePlan Object
Product Object
Payment Provider Object
Payment Method Object
NameValuePair Object
GiftCard Object
Entitlement Object
Chargeback Object
Campaign Object
BillingPlan Object
AutoBill Object
Address Object
Activity Object
Account Object
TransactionItem Subobject
A line-item in a Transaction. Line items may be goods sold, sales tax, or other charges or credits. All line-items added together should add up to the total Transaction amount.
Data Members |
Data Type |
Description |
autoBillItemVid |
string |
Vindicia's unique identifier for the associated AutoBillItem. |
campaignCode |
string |
Campaign code redeemed on this Transaction. To apply a Campaign, use this field to pass in a valid Coupon or Promotion code.
|
campaignDescription |
string |
Description for the Campaign used to discount this transaction, if any. |
campaignId |
string |
Read only. The unique identifier for a Campaign applied to this Transaction. This is a read-only field returned by Vindicia Subscribe for informational purposes. Values sent in with a SOAP call will be ignored. |
discount |
decimal |
Read only. A field describing the discount amount on this transaction. |
indexNumber |
int |
Unique index number for this item. Index numbers start at 1, not 0. |
itemRefunds |
TransactionItemRefundSummary |
Contains a summary of Refunds against a TransactionItem.
|
itemType |
TransactionItemType |
Contains one of the following values. If unspecified, the type will default to Purchase.
As of this release, passing in negative-amount Transaction items to affect an ad hoc custom discount is no longer supported.To achieve the same effect, pass in the absolute value in the amount field for the item and specify DiscountBeforeTax here. |
merchantAutoBillItemId |
string |
Your identifier for the associated AutoBillItem. |
name |
string |
A description of the item. For Vindicia Subscribe-generated rebill transactions in which this Transaction item is derived from a Product or BillingPlan object used with an AutoBill object, this value maps to the Product or BillingPlan object’s description attribute. For TransactionItems which reflect Campaign discounts, this data member will be populated by Vindicia Subscribe with the text "Discount for description," where description is the description data member for the ProductDescription subobject of the Product receiving the discount or the BillingPlanDescription data member of the Billing Plan receiving the discount. |
nameValues |
NameValuePair |
Optional. An array of name‑value pairs the merchant wishes to associate with a Transaction item. NameValues associated with an AutoBillItem will automatically be populated on corresponding TransactionItems. |
price |
decimal |
The item price, denominated by the currency data member of this Transaction object. price is omitted on rated items, because they do not have a fixed, per unit price but are dependent on the tier of the rate plan. |
quantity |
decimal |
The number of items sold. If migrating quantity does not make sense, such as for a sales-tax line item, set quantity to 1, not 0. For rated items, this number can be a fraction. |
relatedTransactions |
string |
List of merchantTransactionIds for all Transactions related to this item. If you have a credit resulting from the removal of an AutoBillItem or BillingPlan, related Transactions contains the list of all Transactions originally billed for the item within the timeframe covered by the credit. |
servicePeriodEndDate |
dateTime |
The start date for the service provided by this TransactionItem. For standard AutoBills, these dates will coincide with the Billing Plan’s bill dates. For AutoBills which include Season Sets, or other variants, these dates might be the same for multiple Transactions. Blank indicates that the entitlement has no end date, and is valid forever, or that the Transaction resulted from a Transaction.auth, capture, or migrate call, in which case this value has no meaning.
|
servicePeriodStartDate |
dateTime |
The start date for the time period reflected by this TransactionItem. |
sku |
string |
Optional. Your SKU or other tracking key for this item. For Vindicia Subscribe-generated rebill transactions in which this transaction item is derived from a Product object used with an AutoBill object, this value maps to the Product object’s merchantProductId attribute. For TransactionItems which reflect Campaign discounts, this data member will be populated by Vindicia Subscribe with the text "Discount for merchantProductId merchantProductId," where merchantProductId is the merchantProductId data member for the Product object receiving the discount. This data member will also be populated by Vindicia Subscribe with the text "Discount for merchantBillingPlanId merchantBillingPlanId," where merchantBillingPlanId is the merchantBillingPlanId data member for the BillingPlan object receiving the discount. |
subtotal |
decimal |
Read only.The subtotal of the values on the TransactionItem, excluding any discounts and taxes, if tax-exclusive. If tax is inclusive, for example a value-added tax (VAT), it will be included. |
tax |
Tax() |
An array of Tax objects, which include the following data members:
|
taxClassification |
string |
A string that defines the tax classification for this TransactionItem. |
taxType |
string |
This data member will be automatically populated by Vindicia Subscribe with applied tax information for the TransactionItem. Possible values include Inclusive Sales, Exclusive Sales, Inclusive Use, and Exclusive Use. |
tokens |
TokenAmount() |
An array of TokenAmount objects granted to the Account on this Transaction for purchasing this item (if Vindicia Subscribe tokens are in use). Each object in the array specifies the quantity of a specific type of token. This is a read-only attribute when Vindicia Subscribe returns the TransactionItem object to you in response to a call. |
total |
decimal |
Read only.The total charge for the transaction, including discounts and taxes. Vindicia Subscribe calculates discount, subtotal, and total. If you pass these in, they will be ignored. |
For Users
Learn More