This topic describes the Pismo platform's object structure and explains how the initial setup process works.
The Pismo platform has a built-in hierarchy of objects, as shown in the following image.
The following table describes these elements and their basic relationships.
This is the top-level object in the structure. It contains one or more programs.
Defines a set of parameters for a group of accounts. (The specific parameters depend on the use case.)
In Visa® and Mastercard® issuing scenarios, the program coincides with a product that is defined by a BIN range.
Contains balances and credit limits as attributes. Each account belongs to a single program and is always tied to a single customer.
Whenever an attribute is not defined for an account, it is inherited from its program.
Accounts can contain an unlimited number of customers, but only one customer can have the
Each account contains at least one customer. The customer object defines an individual (person or company) associated with an account. For example, a person, John Doe, may have a work telephone number associated with a corporate credit card and another phone number associated with a wallet.
No parameters are set at the customer level, but several account parameters use the
Card (or Token)
A customer makes transactions against an account using an issued card. A customer object can have multiple cards.
For security, a token is an encrypted string used in place of actual card information when making an API request.
Entities include transactions, timeline events, addresses, phone numbers, and banking details.
The first step of your journey integrating with the Pismo platform is to set up your organization and your first program.
No API access is possible until your org and program are created. To ensure a smooth setup experience, the Pismo Implementation team guides you through the steps of your setup process.
To set up your org, you must provide the following initial attribute values to the Implementation team:
After your org setup is complete, you use the Pismo Console to create the first program associated with your org. Program attributes depend on the type of program. Program types are:
- Combo (a mix of credit and debit). To do so, you must already have a
debitprogram associated with your org.
- Credit zero-balance
- Pre-paid zero-balance
- Seller management
The initial attributes needed to create any type of program are:
This property defines default settings for newly created cards. For example, you can set new cards to be active when created.
Both of parameters identify the type of program you are creating. (You can use one or the other.)
If you skip this property, its default value is set to
1. Even debit programs require this parameter, as a way of grouping transactions.
Pismo creates a cloud storage container for migrating your data.
Pismo also generates a server key and a secret key that provides you with access to Pismo's APIs.
After the initial setup is completed, Pismo sends an email to the main account holder (Pismo's primary contact at your company) with helpful instructions for accessing our interfaces and account management applications.
Updated 5 months ago