Create a Price

Body Params

type

string

enum

required

String representing the price type. The available options are:

one_time : applies to prices that will only be charged once

recurring : applies to prices that have a recurring frequency and can be added as a subscription

Allowed:

pricingModel

string

enum

required

Pricing Models available:

fixed_amount : In this case, merchant choses how much the customer will pay

customer_chooses : In this case customer chooses the amount that he will pay. Useful for payment links that allow the customer to set the price they want to pay or donate.

Allowed:

billingScheme

string

enum

Describes how to compute the final price to be charged to a customer. Valid options are:

per_unit - Indicates that during a checkout or in a recurring subscription, the final amount to be charged will be equivalent to: billingScheme x quantity

tiered - Indicates that the unit pricing will be computed using a tiering strategy as defined using the tiers and tiers_mode attributes.

Allowed:

currency

string

enum

Three-letter ISO currency code, in lowercase. Must be a supported currency.

Currently only currency supported is usd

Allowed:

amount

float

Amount to be paid per billing unit as set on the billingScheme property . Only applicable when pricingModel=fixed_amount

customerChoosesSettings

object

This is an object that determines defaults and limits for the amount that will be entered by the customer. Only applicable when pricingModel=customer_chooses

recurring

object

This is an object that determines the configuration for when the price is of type recurring.

product

string

Id of product that you want to link the price to.

newProduct

object

Use this object if you want to create a NEW product while creating a NEW price. The product will automatically be associate with the price after creation.

active

boolean

Whether or not the price is active and should be displayed. Defaults to true when created.

Headers

idempotencyKey

string

A unique identifier to ensure the same operation isn't processed multiple times, preventing duplicate transactions.

onBehalfOf

string

Specifies the account for which creating a price is intended. This is used for scenarios where one partner creates price on behalf of another partner, such as in PayFac or related partner relationships

201201

400400