In SpherePay, the Product and Price model provides a structured way for merchants to manage their offerings and set pricing within their payment flows. Whether you're selling physical goods, digital services, or subscriptions, SpherePay allows you to create products, define their prices, and integrate them seamlessly into Payment Links and other payment methods.
This guide explains how Products and Prices work in SpherePay and how they differ from traditional multi-currency pricing models.
Understanding Products in SpherePay
A Product in SpherePay represents an item or service that a merchant sells. Each product is created independently and acts as a reference for one or more prices that determine the cost of the product in different currencies or pricing situations.
📌 Where can you create Products?
Dashboard: Products can be set up when creating a Payment Link.
API: Developers can create and manage products programmatically using the SpherePay Product API.
Example API Request to Create a Product
POST https://api.spherepay.co/v2/product
{
"name": "Monthly Subscription",
"description": "Premium membership with exclusive features",
"metadata": {
"category": "Subscription"
}
}
Understanding Prices in SpherePay
A Price in SpherePay determines how much a Product costs in a specific currency and billing model. Unlike some platforms, SpherePay does not support multi-currency pricing, meaning merchants need to create a separate Price object for each currency or pricing scenario.
📌 Where can you create Prices?
Dashboard: Merchants define pricing while setting up a Payment Link.
API: Developers can create and manage prices using the SpherePay Price API.
Key Features of Prices in SpherePay
✅ Each Price object is linked to a single currency – If a product is sold in multiple currencies, merchants must create multiple Price objects.
✅ Supports one-time and recurring payments – Define pricing models such as fixed, per-unit, or subscription-based.
✅ Cannot be imported – Unlike other platforms, SpherePay does not support bulk importing of products and prices.
Example API Request to Create a Price
POST https://api.spherepay.co/v2/price
{
"product": "product_id",
"currency": "USD",
"amount": 1000,
"billingScheme": "per_unit"
}
📌 Important:
Replace
"product_id"with the actual Product ID you created earlier.If you need the same product available in multiple currencies, create a separate Price object for each currency.
How Products and Prices Work Together
1️⃣ A Product represents the item/service you sell – It contains general information such as the product name, description, and metadata.
2️⃣ A Price defines how much the product costs – It specifies the currency, amount, and billing model.
3️⃣ You link a Price to a Product – Each Price object is attached to a specific product.
4️⃣ Use the Payment Link or API to accept payments – Once Products and Prices are set up, merchants can use them to create Payment Links for customers to complete their purchase.
Where Can You Use Products and Prices in SpherePay?
✔ In the Dashboard – When setting up a Payment Link, merchants can select a Product and assign a Price to it.
✔ Via the API – Developers can integrate Products and Prices into their checkout flows, allowing flexible programmatic control.
Final Thoughts
The Product and Price model in SpherePay allows businesses to easily manage pricing while maintaining flexibility. While multi-currency pricing isn't supported, merchants can still create multiple Price objects for different currencies and scenarios.
For further integration, refer to:
📌 SpherePay Product API
📌 SpherePay Price API
🚀 Start setting up your Products and Prices today and streamline your checkout experience with SpherePay!