PayNow

CreateCheckoutSessionLineManagementDto

Represents a line item in a checkout session request. Opposed to CreateCheckoutSessionLineDto, this is used while creating a checkout session using the Management API, and allows for creating inline products and payout splits (subject to special approval)

quantityintegerRequired
The quantity of this product to purchase
custom_variablesobjectOptional
Key-value pair mapping custom variable identifiers to their selected values. Required only when the product includes custom variables.
gift_toCustomerPlatformAccountDtoOptional
Represents a customer platform association, used for gifting
idstringRequired
The account ID on the platform
platformenumRequired
Possible enum values
  • invalid
  • steam

    Steam profile platform - the ID param must be a Steam ID 64.

  • minecraft

    Minecraft profile platform - the ID param must be a Minecraft nick. If your store platform is Geyser, this automatically sets the Minecraft platform based on the prefix configured in store settings.

  • paynow_name

    PayNow name profile platform - the ID param must be a PayNow username.

  • paynow

    PayNow name profile platform - the ID param must be a PayNow username.

  • minecraft_java_name

    Minecraft Java Profile Platform - the ID param must be a Java minecraft nick.

  • minecraft_bedrock_name

    Minecraft Bedrock Profile Platform - the ID param must be a Bedrock minecraft nick.

  • xbox_xuid

    Minecraft Xbox XUID Profile Platform - the ID param must be an xbox xuid

  • minecraft_uuid

    Minecraft profile platform - the ID param must be a Minecraft UUID.

gift_to_customer_idFlakeIdOptional
inline_productInlineProductCreateDtoOptional
Optional inline product definition for dynamic products. Requires special approval, use `product_id` instead.
allow_concurrent_active_itemsbooleanOptional
Indicates whether concurrent active items are allowed.
allow_one_time_purchasebooleanOptional
Indicates whether one-time purchases are allowed.
allow_subscriptionbooleanOptional
Indicates whether subscription purchases are allowed.
commandsProductCommandDto[]Optional
The commands to be executed at different stages.
contentstringRequired
Content of the command.
online_onlybooleanRequired
Value indicating whether the command should only execute when the player is online.
stageenumRequired
Defines the stages at which product commands can be executed.
Possible enum values
  • invalid

    Represents an invalid or unspecified command stage.

  • on_purchase

    Commands that should be executed when a product is purchased.

  • on_expire

    Commands that should be executed when a product expires.

  • on_refund

    Commands that should be executed when a product is refunded.

  • on_renew

    Commands that should be executed when a subscription is renewed.

  • on_chargeback

    Commands that should be executed when an order is charged back.

  • on_trial_start

    Commands that should be executed when a trial is started.

  • on_trial_expire

    Commands that should be executed when a trial expires.

override_execute_on_gameserver_idsFlakeId[]Optional
Value indicating on which game servers should the command be executed. If left empty or null, then the default behavior applies (executing on all game servers or on the selected game server is selection is enabled)
custom_variable_idsFlakeId[]Optional
The IDs of associated custom variables.
customer_stock_limitProductStockLimitDtoOptional
enabledbooleanRequired
Indicates whether stock limit is enabled.
include_trialsbooleanRequired
Indicates if trials should be included in the active stock limit calculation.
time_scaleenumRequired
Possible enum values
  • invalid
  • day
  • week
  • month
  • year
quantityintegerOptional
The quantity limit.
time_valueintegerOptional
The time value for stock limit period.
deliverable_actionsProductDeliverableActionsDtoOptional
grant_giftcardbooleanRequired
Value indicating whether to grant a giftcard with the product with the subtotal amount.
descriptionstringOptional
The detailed description of the product.
enabled_atstringOptional
The date and time when the product becomes enabled. Set to `null` to keep enabled.
enabled_untilstringOptional
The date and time until which the product remains enabled. Set to `null` to keep enabled.
gameserversFlakeId[]Optional
The gameserver IDs associated with the product.
is_affiliate_links_disabledbooleanOptional
Indicates if applying affiliate links should be disabled on the product.
is_coupons_disabledbooleanOptional
Indicates if applying coupons should be disabled on the product.
is_gift_cards_disabledbooleanOptional
Indicates if applying gift cards should be disabled on the product.
is_gifting_disabledbooleanOptional
Indicates whether gifting is disabled.
is_hiddenbooleanOptional
Indicates whether the product is hidden.
labelstringOptional
The display label for the product.
metadataobjectOptional
Additional metadata for the product.
namestringOptional
The display name of the product.
payout_splitsProductPayoutSplitDto[]Optional
The payout splits for revenue distribution. Requires special approval.
platform_feeintegerRequired
The platform fee percentage your platform receives, in basis points (500 = 5%).
user_idFlakeIdRequired
percentageintegerOptional
The percentage of the payment allocated to the user, in basis points (500 = 5%). The last payout split must have this field set to `null` to receive the remaining portion.
priceintegerOptional
The price of the product in the lowest denominator (e.g. cents).
remove_after_enabledbooleanOptional
Indicates whether automatic removal is enabled.
remove_after_time_scaleenumOptional
Possible enum values
  • invalid
  • day
  • week
  • month
remove_after_time_valueintegerOptional
The time value for automatic removal.
required_product_allbooleanOptional
Indicates whether all required products are needed.
required_product_idsFlakeId[]Optional
The IDs of products required for purchasing this product.
single_game_server_onlybooleanOptional
Indicates whether the customer is prompted to select a game server before purchasing.
slugstringOptional
The unique URL-safe identifier (slug) for the product.
stock_limit_do_not_include_removedbooleanOptional
Indicates whether removed items should be excluded from stock limits.
store_stock_limitProductStockLimitDtoOptional
enabledbooleanRequired
Indicates whether stock limit is enabled.
include_trialsbooleanRequired
Indicates if trials should be included in the active stock limit calculation.
time_scaleenumRequired
Possible enum values
  • invalid
  • day
  • week
  • month
  • year
quantityintegerOptional
The quantity limit.
time_valueintegerOptional
The time value for stock limit period.
subscription_interval_scaleenumOptional
Possible enum values
  • invalid
  • day
  • week
  • month
  • year
subscription_interval_valueintegerOptional
The subscription interval value.
tagsFlakeId[]Optional
The tag IDs associated with the product.
tax_codeenumOptional
Determines the category of the product for taxation purposes. Contact support for help with setting the correct tax code.
Possible enum values
  • unknown

    Unknown tax code.

  • digital_goods_subscription

    You provide customers access to photographs, audiovisual works, audio works, and books, delivered electronically to a customer for non-permanent access, with right of use conditioned on continued payment to the seller.

  • digital_goods_permanent

    You provide customers access to photographs, audiovisual works, audio works, and books, delivered electronically to a customer.

  • saas

    SaaS: Pre-written software, delivered electronically. You provide customers access to a hosted software application, described as computer programs designed to permit the user to perform a group of coordinated functions, tasks, or activities. You are typically responsible for all aspects of making the software service available.

  • downloaded_software

    Pre-written, non-custom computer software that is delivered electronically for download onto customers' devices/servers. No tangible personal property (e.g. CD-ROM, etc.) is delivered or used in conjunction with the download.

  • digital_goods_subscription_gaming

    Cloud based or downloaded access to digital gaming services (used by default for game servers).

  • digital_goods_permanent_gaming

    Permanent digital goods for gaming (not recommended).

  • iaas

    Infrastructure as a Service: Providing users remote access to data center equipment and computing power.

  • paas

    Platform as a Service: A cloud computing service bundle that includes both the infrastructure (servers, storage, and networking) and the middleware (development tools, business intelligence services, database management systems) that provides the customer a complete development and deployment environment in the cloud.

  • saas_security

    Cloud-based SaaS, designed to secure customer data. Pre-written software, delivered electronically, designed specifically to provide protection of computer systems, software, or data against unauthorized access or intrusion. This includes separately charged maintenance and updates delivered electronically, whether included in the cost of the software or charged as a separate line item.

  • saas_storage

    Cloud-based SaaS, designed to backup customer data. Pre-written software, delivered electronically, designed purely as storage for a customer's data. You provide customers access to a software product solely to facilitate the storage of digital products, digital codes, computer software or master copies of software. This includes separately charged maintenance and updates delivered electronically, whether included in the cost of the software or charged as a separate line item.

tier_group_idFlakeIdOptional
trialUpsertProductTrialConfigurationDtoOptional
Represents the configuration for trials of a product
allow_repeat_trialsbooleanOptional
Allows customers to trial again after a cooldown period following their previous trial. When disabled, customers can only trial once and never become eligible again.
enabledbooleanOptional
Indicates if trials should be enabled for the product.
new_customer_order_lookback_scaleenumOptional
Possible enum values
  • invalid
  • day
  • week
  • month
  • year
new_customer_order_lookback_valueintegerOptional
The lookback period value for determining if a customer is "new". Only used when new_customers_only is enabled.
new_customers_onlybooleanOptional
Restricts trials to customers who have no orders within the lookback period. When enabled, customers with recent orders will be ineligible for trials.
period_scaleenumOptional
Possible enum values
  • invalid
  • day
  • week
  • month
  • year
period_valueintegerOptional
The trial period value.
repeat_trial_cooldown_scaleenumOptional
Possible enum values
  • invalid
  • day
  • week
  • month
  • year
repeat_trial_cooldown_valueintegerOptional
The cooldown period value before a customer becomes eligible for another trial. Only used when allow_repeat_trials is enabled.
revoke_immediately_when_canceledbooleanOptional
Indicates if the trial should be revoked immediately when canceled or at the end of the trial.
upsellingUpsertProductUpsellConfigurationDtoOptional
enabledbooleanOptional
recommendationsUpsertProductUpsellRecommendationDto[]Optional
→ UpsertProductUpsellRecommendationDto
metadataobjectOptional
Optional metadata to associate with the checkout session line. Do not store any sensitive information here.
payout_splitsCreateCheckoutSessionLineManagementPayoutSplitDto[]Optional
Optional payout splits for line items (requires approval)
payout_idstringRequired
The ID of the user's payout balance.
percentageintegerOptional
The percentage of the line amount this user receives (in basis points, e.g., 5000 = 50%) NOTE: The last payout split needs to have a null percentage set (so the remaining amount gets properly allocated)
platform_feeintegerOptional
The platform fee percentage applied to this split (in basis points) Only applicable to platforms.
product_idFlakeIdOptional
selected_gameserver_idFlakeIdOptional
subscriptionbooleanOptional
Determines whether this line should create a subscription
trialbooleanOptional
Indicates whether the product should be trialed
Example
{
  "quantity": 0,
  "subscription": true,
  "trial": true,
  "gift_to": {
    "id": "76561198152492642",
    "platform": "invalid"
  },
  "gift_to_customer_id": "411486491630370816",
  "selected_gameserver_id": "411486491630370816",
  "custom_variables": {},
  "product_id": "411486491630370816",
  "inline_product": {
    "slug": "string",
    "name": "string",
    "description": "string",
    "label": "string",
    "price": 0,
    "single_game_server_only": true,
    "allow_one_time_purchase": true,
    "allow_subscription": true,
    "subscription_interval_value": 0,
    "subscription_interval_scale": "invalid",
    "trial": {
      "enabled": true,
      "period_value": 0,
      "period_scale": "invalid",
      "revoke_immediately_when_canceled": true,
      "new_customers_only": true,
      "new_customer_order_lookback_value": 0,
      "new_customer_order_lookback_scale": "invalid",
      "allow_repeat_trials": true,
      "repeat_trial_cooldown_value": 0,
      "repeat_trial_cooldown_scale": "invalid"
    },
    "upselling": {
      "enabled": true,
      "recommendations": [
        {
          "discount_amount": 0,
          "discount_type": "unknown",
          "prefer_as_subscription": true,
          "recommended_product_id": "411486491630370816",
          "type": "unknown",
          "minimum_base_product_quantity": 0,
          "minimum_recommended_product_quantity": 0,
          "quantity_to_add": 0
        }
      ]
    },
    "remove_after_enabled": true,
    "remove_after_time_value": 0,
    "remove_after_time_scale": "invalid",
    "store_stock_limit": {
      "enabled": true,
      "include_trials": true,
      "time_scale": "invalid",
      "quantity": 0,
      "time_value": 0
    },
    "customer_stock_limit": {
      "enabled": true,
      "include_trials": true,
      "time_scale": "invalid",
      "quantity": 0,
      "time_value": 0
    },
    "stock_limit_do_not_include_removed": true,
    "tags": [
      "411486491630370816"
    ],
    "gameservers": [
      "411486491630370816"
    ],
    "commands": [
      {
        "content": "string",
        "online_only": true,
        "stage": "invalid",
        "override_execute_on_gameserver_ids": [
          "411486491630370816"
        ]
      }
    ],
    "deliverable_actions": {
      "grant_giftcard": true
    },
    "metadata": {},
    "payout_splits": [
      {
        "platform_fee": 0,
        "user_id": "411486491630370816",
        "percentage": 0
      }
    ],
    "tax_code": "unknown",
    "allow_concurrent_active_items": true,
    "is_hidden": true,
    "is_gifting_disabled": true,
    "enabled_at": "2024-01-01T00:00:00Z",
    "enabled_until": "2024-01-01T00:00:00Z",
    "required_product_ids": [
      "411486491630370816"
    ],
    "required_product_all": true,
    "custom_variable_ids": [
      "411486491630370816"
    ],
    "is_gift_cards_disabled": true,
    "is_coupons_disabled": true,
    "is_affiliate_links_disabled": true,
    "tier_group_id": "411486491630370816"
  },
  "payout_splits": [
    {
      "payout_id": "string",
      "percentage": 5000,
      "platform_fee": 500
    }
  ],
  "metadata": {}
}