1. Overview of Value Types
Revolv3 offers the following line item value types:
Value TypeDescriptionExample Value
Standard (Default)A regular charge applied to the total.”Value”: 0.19 (19 cents added)
DiscountA fixed discount subtracted from the total.”Value”: 0.19 (19 cents subtracted)
DiscountPercentageA percentage discount applied to the total.”Value”: 10 (10% discount)
FinalDiscountA one-time discount applied to the last payment in a subscription.Only for subscriptions
PriceOverrideA set price that ignores other item values.”Value”: 0.19 (final price is 19 cents)
  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

ItemPriceType
Product 123$1.09Standard
Test Discount-$0.19Discount
Total$0.90Final Price
✅ 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

ItemPriceType
Product 123$1.09Standard
% Discount-19%Discount Percentage
Total$0.88Final Price
✅ 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

ItemPriceType
Product 123$1.09Standard
Over-ride$0.19Price Override
Total$0.19Final Price
✅ 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.
Embedded page