Seller management overview
Pismo Seller management provides a complete solution for managing merchants that sell products through online channels and at physical points of sale. Any business that needs to manage sellers can use the Seller management platform, including merchant banks, fintechs, marketplaces, and payment facilitators.
When planning and implementing your seller marketplace, refer to Seller management onboarding and Get started with seller management. To access Seller management in Control Center, your user role must have Seller management admin permission. The following sections provide a conceptual overview of seller management and the associated data models.
Two main concepts in Seller management
- Marketplace – a grouping of merchants who sell products online or at physical points of sale. The marketplace applies a fee to sales.
- Merchant – an individual or business that sells products or services in the marketplace.
The platform supports all transaction types, including card network transactions processed outside the institution (off‑us and open loop), card transactions processed within the same institution (on‑us), transfers between accounts in the same institution (closed loop), and transfers between different institutions through instant payments.
Pismo Seller management provides a solution for every aspect of seller management. The platform can manage:
- Marketplaces – a marketplace can include one or more sellers.
- Merchants – a merchant can link to one or more marketplaces.
- Merchant accounts – a merchant account receives funds from sales. In Seller management, merchant accounts are called creditor accounts and link to a creditor object.
- Rates and fees – charges that the merchant incurs on sales. In Seller management, you configure these within the marketplace creditor operation object. Rates and fees may vary by transaction type.
- Settlement – the process of finalizing a transaction and transferring funds to the merchant’s account. Settlement can occur inside Pismo (internal transfer) or outside Pismo (external transfer).
- Schedules – define when settlement occurs, such as 2 days after the sale, 30 days after the sale, or the same day as the sale.
- Advancements – merchants can request an advancement before the scheduled settlement date. An additional rate or fee applies.
Benefits of Pismo Seller management
- Manage vendors and buyers on the same platform. Seller management manages vendors, and you can use other Pismo services such as Accounts and Core Banking to manage buyers.
- Control all settlement processes, from authorization to payment. Settlements can be internal to the Pismo platform or external using account identifiers.
- Use any payment scheme. The platform supports card network, closed-loop, and other payment methods.
- Create flexible receivables schedules. Use creditor operations to define conditions for each transaction type, set payment timing, and configure merchant discount rates (MDRs) and other fees.
- Handle transactions from on-us and off-us merchants. The platform supports all transaction types. You can use card services for off‑us transactions, payment services for on‑us transactions, or authorize transactions externally and send the authorized transactions to the Pismo platform.
Basic object structure
This section explains the main objects that make up your digital marketplace.
Organization (Org)
The organization object defines your company or enterprise. It contains one or more programs. For more information, refer to Organization.
Program
The program object defines a set of parameters for credit, debit, or pre-paid accounts. In Seller management, it defines parameters for a marketplace account. For more information, refer to Program types and parameters.
Marketplace
The marketplace object is the top-level object in your digital marketplace. You create a marketplace and configure it to support your business needs. A merketplace can represent a single merchant or a group of merchants that share tax and setup requirements. It also defines the settlement schedule for all merchants in that marketplace.
Use the Create marketplace endpoint to create a new marketplace.
Merchant
The merchant object represents a business that sells products or services in your marketplace. A merchant can be any type of seller, such as a gas station or an e-commerce store. Each merchant includes a transaction register and a settlement schedule within the marketplace.
Use the Create merchant endpoint to create a merchant, then use Link merchant to marketplace to add it to a marketplace.
Creditor
The creditor object represents the owner of a business. It links to a merchan and includes a bank object, which contains the merchant account. This account receives the funds from sales during settlement.
You create the creditor at the same time you create the merchant using Create merchant.
You can also create a creditor using “Create a creditor,” but creditors created in this way do not include an account. Pismo recommends using Create merchant to ensure the creditor has an associated account.
Marketplace creditor operation
For each sale, the merchant pays a fee or rate to the marketplace. This fee is the merchant discount rate (MDR). The marketplace creditor operation object enables the creditor to configure MDR values, sales rates, and other required fees.
To create a creditor operation, use Create creditor operation. Pass the merchant ID in merchant_id , the marketplace ID in marketplace_id, and the creditor ID in creditor_id.
You can create multiple creditor operations for a creditor and its merchants. Each operation can define different rates, fees, and payment intervals, depending on the transaction type (such as transactions with or without installments or interest).
A merchant links to one creditor, but a creditor can link to multiple merchants.
Updated 4 days ago