Introducing PERS (Phygital Experience Rewards System) the ultimate SaaS of Loyalty & Reward System. Connect PERS API to your system and get ready to create multi-projects, with your own dashboard and independent database, while ensuring users data confidentiality. This structure enables:
The Claim System Flow in SaaS PERS outlines the process through which rewards and tokens can be claimed by different entities within the system. This flow ensures that the claiming process is secure, efficient, and flexible, catering to various use cases and integration requirements. 
This flow ensures that the process of claiming rewards is adaptable to various scenarios, making it seamless for system administrators, business partners, and end-users to interact with the reward system efficiently.
The Business module encompasses all participants and partners involved in the reward system. This includes the partner community, such as vendors, service providers, artist community, commercial partners, public or private institutions and other entities that contribute to the reward ecosystem. Key features of the Business module include:
curl -i -X POST \
https://docs.pers.ninja/_mock/swagger/business/admin/type \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"name": "string",
"description": "string",
"code": "string",
"iconUrl": "string"
}'{ "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }
curl -i -X PUT \
https://docs.pers.ninja/_mock/swagger/business/admin/type \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"id": 0,
"name": "string",
"description": "string",
"code": "string",
"iconUrl": "string"
}'{ "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }
curl -i -X DELETE \
'https://docs.pers.ninja/_mock/swagger/business/admin/type/{id}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'curl -i -X GET \
https://docs.pers.ninja/_mock/swagger/business/type \
-H 'x-project-key: YOUR_API_KEY_HERE'{ "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }
curl -i -X GET \
https://docs.pers.ninja/_mock/swagger/business/business/me \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-project-key: YOUR_API_KEY_HERE'Business found
The address of the business, this is the address that will be shown to the public.
The legal name of the business, this is the name that will be used for legal purposes.
The display name of the business, this is the name that will be shown to the public.
The description of the business, this is the description that will be shown to the public.
The short description of the business, this is the description that will be shown to the public.
The address of the business, this is the address that will be shown to the public.
The postal code of the business, this is the postal code that will be shown to the public.
The latitude of the business, this is the latitude that will be shown to the public.
The longitude of the business, this is the longitude that will be shown to the public.
The business type of the business, this is the business type that will be shown to the public.
The status of the business, this is the status that will be shown to the public.
The ability to mint token for the business, this is the ability that will be shown to the public.
The ability to charge token for the business, this is the ability that will be shown to the public.
The ability to manage users for the business, this is the ability that will be shown to the public.
The ability to receive donation for the business, this is the ability that will be shown to the public.
The token balances of the business, this is the token balances that will be shown to the public.
{ "id": "string", "email": "string", "accountAddress": "string", "businessLegalName": "string", "displayName": "string", "description": "string", "shortDescription": "string", "websiteUrl": "string", "imageUrl": "string", "streetAddress": "string", "city": "string", "postalCode": "string", "coordsLatitude": 0, "coordsLongitude": 0, "businessType": { "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }, "isActive": true, "canMintToken": true, "canChargeToken": true, "canManageUsers": true, "canReceiveDonation": true, "tokenBalances": [ { … } ] }
curl -i -X GET \
https://docs.pers.ninja/_mock/swagger/business \
-H 'x-project-key: YOUR_API_KEY_HERE'Business found
The address of the business, this is the address that will be shown to the public.
The legal name of the business, this is the name that will be used for legal purposes.
The display name of the business, this is the name that will be shown to the public.
The description of the business, this is the description that will be shown to the public.
The short description of the business, this is the description that will be shown to the public.
The address of the business, this is the address that will be shown to the public.
The postal code of the business, this is the postal code that will be shown to the public.
The latitude of the business, this is the latitude that will be shown to the public.
The longitude of the business, this is the longitude that will be shown to the public.
The business type of the business, this is the business type that will be shown to the public.
The status of the business, this is the status that will be shown to the public.
The ability to mint token for the business, this is the ability that will be shown to the public.
The ability to charge token for the business, this is the ability that will be shown to the public.
The ability to manage users for the business, this is the ability that will be shown to the public.
{ "id": "string", "email": "string", "accountAddress": "string", "businessLegalName": "string", "displayName": "string", "description": "string", "shortDescription": "string", "websiteUrl": "string", "imageUrl": "string", "streetAddress": "string", "city": "string", "postalCode": "string", "coordsLatitude": 0, "coordsLongitude": 0, "businessType": { "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }, "isActive": true, "canMintToken": true, "canChargeToken": true, "canManageUsers": true, "canReceiveDonation": true }
curl -i -X GET \
'https://docs.pers.ninja/_mock/swagger/business/admin?active=string&sanitize=string' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Business found
The address of the business, this is the address that will be shown to the public.
The legal name of the business, this is the name that will be used for legal purposes.
The display name of the business, this is the name that will be shown to the public.
The description of the business, this is the description that will be shown to the public.
The short description of the business, this is the description that will be shown to the public.
The address of the business, this is the address that will be shown to the public.
The postal code of the business, this is the postal code that will be shown to the public.
The latitude of the business, this is the latitude that will be shown to the public.
The longitude of the business, this is the longitude that will be shown to the public.
The business type of the business, this is the business type that will be shown to the public.
The status of the business, this is the status that will be shown to the public.
The ability to mint token for the business, this is the ability that will be shown to the public.
The ability to charge token for the business, this is the ability that will be shown to the public.
The ability to manage users for the business, this is the ability that will be shown to the public.
{ "id": "string", "email": "string", "accountAddress": "string", "businessLegalName": "string", "displayName": "string", "description": "string", "shortDescription": "string", "websiteUrl": "string", "imageUrl": "string", "streetAddress": "string", "city": "string", "postalCode": "string", "coordsLatitude": 0, "coordsLongitude": 0, "businessType": { "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }, "isActive": true, "canMintToken": true, "canChargeToken": true, "canManageUsers": true, "canReceiveDonation": true }
curl -i -X POST \
https://docs.pers.ninja/_mock/swagger/business/admin \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"displayName": "string"
}'Business created
The address of the business, this is the address that will be shown to the public.
The legal name of the business, this is the name that will be used for legal purposes.
The display name of the business, this is the name that will be shown to the public.
The description of the business, this is the description that will be shown to the public.
The short description of the business, this is the description that will be shown to the public.
The address of the business, this is the address that will be shown to the public.
The postal code of the business, this is the postal code that will be shown to the public.
The latitude of the business, this is the latitude that will be shown to the public.
The longitude of the business, this is the longitude that will be shown to the public.
The business type of the business, this is the business type that will be shown to the public.
The status of the business, this is the status that will be shown to the public.
The ability to mint token for the business, this is the ability that will be shown to the public.
The ability to charge token for the business, this is the ability that will be shown to the public.
The ability to manage users for the business, this is the ability that will be shown to the public.
The ability to receive donation for the business, this is the ability that will be shown to the public.
{ "id": "string", "email": "string", "accountAddress": "string", "businessLegalName": "string", "displayName": "string", "description": "string", "shortDescription": "string", "websiteUrl": "string", "imageUrl": "string", "streetAddress": "string", "city": "string", "postalCode": "string", "coordsLatitude": 0, "coordsLongitude": 0, "businessType": { "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }, "isActive": true, "canMintToken": true, "canChargeToken": true, "canManageUsers": true, "canReceiveDonation": true, "apiPrivateKey": "string" }
curl -i -X GET \
'https://docs.pers.ninja/_mock/swagger/business/account/{accountAddress}' \
-H 'x-project-key: YOUR_API_KEY_HERE'Business found
The address of the business, this is the address that will be shown to the public.
The legal name of the business, this is the name that will be used for legal purposes.
The display name of the business, this is the name that will be shown to the public.
The description of the business, this is the description that will be shown to the public.
The short description of the business, this is the description that will be shown to the public.
The address of the business, this is the address that will be shown to the public.
The postal code of the business, this is the postal code that will be shown to the public.
The latitude of the business, this is the latitude that will be shown to the public.
The longitude of the business, this is the longitude that will be shown to the public.
The business type of the business, this is the business type that will be shown to the public.
The status of the business, this is the status that will be shown to the public.
The ability to mint token for the business, this is the ability that will be shown to the public.
The ability to charge token for the business, this is the ability that will be shown to the public.
The ability to manage users for the business, this is the ability that will be shown to the public.
{ "id": "string", "email": "string", "accountAddress": "string", "businessLegalName": "string", "displayName": "string", "description": "string", "shortDescription": "string", "websiteUrl": "string", "imageUrl": "string", "streetAddress": "string", "city": "string", "postalCode": "string", "coordsLatitude": 0, "coordsLongitude": 0, "businessType": { "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }, "isActive": true, "canMintToken": true, "canChargeToken": true, "canManageUsers": true, "canReceiveDonation": true }
curl -i -X GET \
'https://docs.pers.ninja/_mock/swagger/business/{id}' \
-H 'x-project-key: YOUR_API_KEY_HERE'Business found
The address of the business, this is the address that will be shown to the public.
The legal name of the business, this is the name that will be used for legal purposes.
The display name of the business, this is the name that will be shown to the public.
The description of the business, this is the description that will be shown to the public.
The short description of the business, this is the description that will be shown to the public.
The address of the business, this is the address that will be shown to the public.
The postal code of the business, this is the postal code that will be shown to the public.
The latitude of the business, this is the latitude that will be shown to the public.
The longitude of the business, this is the longitude that will be shown to the public.
The business type of the business, this is the business type that will be shown to the public.
The status of the business, this is the status that will be shown to the public.
The ability to mint token for the business, this is the ability that will be shown to the public.
The ability to charge token for the business, this is the ability that will be shown to the public.
The ability to manage users for the business, this is the ability that will be shown to the public.
{ "id": "string", "email": "string", "accountAddress": "string", "businessLegalName": "string", "displayName": "string", "description": "string", "shortDescription": "string", "websiteUrl": "string", "imageUrl": "string", "streetAddress": "string", "city": "string", "postalCode": "string", "coordsLatitude": 0, "coordsLongitude": 0, "businessType": { "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }, "isActive": true, "canMintToken": true, "canChargeToken": true, "canManageUsers": true, "canReceiveDonation": true }
curl -i -X PUT \
'https://docs.pers.ninja/_mock/swagger/business/admin/{id}/api-key' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'The legal name of the business, this is the name that will be used for legal purposes.
The display name of the business, this is the name that will be shown to the public.
The description of the business, this is the description that will be shown to the public.
The short description of the business, this is the description that will be shown to the public.
The address of the business, this is the address that will be shown to the public.
The postal code of the business, this is the postal code that will be shown to the public.
The latitude of the business, this is the latitude that will be shown to the public.
The longitude of the business, this is the longitude that will be shown to the public
curl -i -X PUT \
'https://docs.pers.ninja/_mock/swagger/business/admin/{id}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"email": "string",
"businessLegalName": "string",
"displayName": "string",
"description": "string",
"shortDescription": "string",
"websiteUrl": "string",
"imageUrl": "string",
"streetAddress": "string",
"city": "string",
"postalCode": "string",
"coordsLatitude": 0,
"coordsLongitude": 0,
"businessTypeId": 0
}'Business created
The address of the business, this is the address that will be shown to the public.
The legal name of the business, this is the name that will be used for legal purposes.
The display name of the business, this is the name that will be shown to the public.
The description of the business, this is the description that will be shown to the public.
The short description of the business, this is the description that will be shown to the public.
The address of the business, this is the address that will be shown to the public.
The postal code of the business, this is the postal code that will be shown to the public.
The latitude of the business, this is the latitude that will be shown to the public.
The longitude of the business, this is the longitude that will be shown to the public.
The business type of the business, this is the business type that will be shown to the public.
The status of the business, this is the status that will be shown to the public.
The ability to mint token for the business, this is the ability that will be shown to the public.
The ability to charge token for the business, this is the ability that will be shown to the public.
The ability to manage users for the business, this is the ability that will be shown to the public.
The ability to receive donation for the business, this is the ability that will be shown to the public.
The token balances of the business, this is the token balances that will be shown to the public.
{ "id": "string", "email": "string", "accountAddress": "string", "businessLegalName": "string", "displayName": "string", "description": "string", "shortDescription": "string", "websiteUrl": "string", "imageUrl": "string", "streetAddress": "string", "city": "string", "postalCode": "string", "coordsLatitude": 0, "coordsLongitude": 0, "businessType": { "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }, "isActive": true, "canMintToken": true, "canChargeToken": true, "canManageUsers": true, "canReceiveDonation": true, "tokenBalances": [ { … } ] }
curl -i -X PUT \
'https://docs.pers.ninja/_mock/swagger/business/admin/activate/{id}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"isActive": true,
"canMintToken": true,
"canChargeToken": true,
"canManageUsers": true,
"canReceiveDonation": true
}'Business account permissions updated
The address of the business, this is the address that will be shown to the public.
The legal name of the business, this is the name that will be used for legal purposes.
The display name of the business, this is the name that will be shown to the public.
The description of the business, this is the description that will be shown to the public.
The short description of the business, this is the description that will be shown to the public.
The address of the business, this is the address that will be shown to the public.
The postal code of the business, this is the postal code that will be shown to the public.
The latitude of the business, this is the latitude that will be shown to the public.
The longitude of the business, this is the longitude that will be shown to the public.
The business type of the business, this is the business type that will be shown to the public.
The status of the business, this is the status that will be shown to the public.
The ability to mint token for the business, this is the ability that will be shown to the public.
The ability to charge token for the business, this is the ability that will be shown to the public.
The ability to manage users for the business, this is the ability that will be shown to the public.
{ "id": "string", "email": "string", "accountAddress": "string", "businessLegalName": "string", "displayName": "string", "description": "string", "shortDescription": "string", "websiteUrl": "string", "imageUrl": "string", "streetAddress": "string", "city": "string", "postalCode": "string", "coordsLatitude": 0, "coordsLongitude": 0, "businessType": { "id": 0, "name": "string", "description": "string", "code": "string", "iconUrl": "string" }, "isActive": true, "canMintToken": true, "canChargeToken": true, "canManageUsers": true, "canReceiveDonation": true }