Checkout Line Items Value Types

Revolv3’s Checkout Line Items Value Types provide flexibility in defining how different charges, discounts, and price overrides are applied to payments. This guide explains the available value types and how they affect the checkout process.

1. Overview of Value Types

Revolv3 offers the following line item value types:

1. Standard and Discount Usage Example

The example below demonstrates a standard charge and a fixed discount being applied to a checkout transaction.

API Request Example

{
  "ReturnUrl": "",
  "OneTimePayment": {
    "CheckoutLineItems": [
      {
        "Name": "Product 123",
        "Value": 1.09,
        "Description": "Testing a payment",
        "ValueType": "Standard"
      },
      {
        "Name": "Test Discount",
        "Value": 0.19,
        "Description": "Discount of 19 cents",
        "ValueType": "Discount"
      }
    ]
  }
}

Will display:

Checkout Display Output

✅ The total amount after applying the discount is $0.90.

1. DiscountPercentage Example

A percentage-based discount reduces the total cost by a percentage rather than a fixed amount.

Will display:

Checkout Display Output with a 19% Discount

✅ The 19% discount results in a total of $0.88.

1. PriceOverride Example

A PriceOverride sets a specific final price, ignoring all other item values.

API Request Example

{
  "OneTimePayment": {
    "CheckoutLineItems": [
      {
        "Name": "Product 123",
        "Value": 1.09,
        "Description": "Testing a payment",
        "ValueType": "Standard"
      },
      {
        "Name": "Over-ride",
        "Value": 0.19,
        "Description": "Override the price",
        "ValueType": "PriceOverride"
      }
    ]
  }
}

Will display:

Checkout Display Output

✅ The total is $0.19, overriding all previous amounts.

1. FinalDiscount for Subscriptions

The FinalDiscount type is exclusively for subscriptions, applying a discount to the final payment in the billing cycle.

🚧 Feature Coming Soon – This value type will be implemented for future subscription checkout pages.