Price Plan is a core entity and is used to manage how prices are set and updated for Acquiring Partners and Partners. Standard Price Plan rates can be overridden for matching transactions on a specific Payment Account by activating a Bespoke Pricing Configuration — see
Enable bespoke pricing for the activation flow.
Relationships & Dependencies
Each Price Plan is linked to a Rate Card, which stores the actual rates. Rate Cards are reusable and required for every Price Plan. A
Partner Account can have multiple Price Plans, but only one is required for onboarding.
graph
%% Nodes
PA(Partner Account)
PP(Payment Profile)
PPD(Payment Product)
PPLAN(Price Plan)
%% Relationships
PA -->|1..1| PP
PP -->|1..n| PPD
PPD -->|1..1| PPLAN
class PPLAN primaryEntity
Resource Properties
Lifecycle
stateDiagram
Price_Plan_Default : Price Plan
Price_Plan_Version_1 : Price Plan Version 1
Price_Plan_Version_2 : Price Plan Version 2
Rate_Card_Standard_GKD : Rate Card A
Rate_Card_Default : Rate Card B
Price_Plan_Default --> Price_Plan_Version_1 : Active, Effective from 2024-01-01 until 2024-03-31
Price_Plan_Default --> Price_Plan_Version_2 : Inactive, Effective from 2024-04-01
Price_Plan_Version_1 --> Rate_Card_Standard_GKD
Price_Plan_Version_2 --> Rate_Card_Default
Price Plans can have multiple versions, allowing for future-dated changes and version control. The management process includes creating the Rate Card, associating it with a Price Plan, and setting effective dates. The process is documented and managed internally, with specific steps for creation, updating, and sharing with partners. When a Price Plan has been requested and created, it can only have one state: Published.
Integration with Partner Management API
To expose and use Price Plans in transactions and for partners, Partner Management API sets its price plan id in the distribution profile.
Frequent Use Cases
Create a Price Plan for new Acquiring Partner
Pricing Team while onboarding process can request Price Plan creation.
Use Price Plan to price transaction
Every transaction will be priced by requested parameters such as Price Plan and Payment Program and others.
Get Price Plans for Acquiring Partner