PERS-api docs (1.8.2)
https://docs.pers.ninja/_mock/swagger/
https://explorins-loyalty.ngrok.io/
https://api.pers.ninja/v1.8/
Introduction
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:
- Interoperable Rewards
- Boost Customer Engagement
- Simplified Management
- Effortless Integration
- Security and Privacy
- Data-Driven Strategy
Claim Campaign
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.
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/stripe-webhook
https://explorins-loyalty.ngrok.io/purchase/stripe-webhook
https://api.pers.ninja/v1.8/purchase/stripe-webhook
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.pers.ninja/_mock/swagger/purchase/stripe-webhook- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/admin/token
https://explorins-loyalty.ngrok.io/purchase/admin/token
https://api.pers.ninja/v1.8/purchase/admin/token
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.pers.ninja/_mock/swagger/purchase/admin/token \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"tokenId": "string",
"description": "string",
"purchaseTypeId": 0
}'Token created
Token
Metadata of the token, this is optional and can be null in case of Point token
this is the abi of the contract, this is the interface of the contract to interact with it
this is the url of the abi of the contract, to be used to fetch the abi of the contract
this is the decimals of the token. This is optional and only used for ERC20 tokens (Points)
Purchase Type
{ "id": "string", "description": "string", "token": { "id": "string", "contractAddress": "string", "metadata": {}, "abi": {}, "chainId": 0, "abiUrl": {}, "name": "string", "symbol": "string", "decimals": 0, "isActive": true, "isGallery": true, "type": "ERC20" }, "contractTokenId": {}, "purchaseType": { "conversionRate": 0, "currency": "eur", "id": 0 }, "isActive": true }
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/admin/token/{id}
https://explorins-loyalty.ngrok.io/purchase/admin/token/{id}
https://api.pers.ninja/v1.8/purchase/admin/token/{id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
'https://docs.pers.ninja/_mock/swagger/purchase/admin/token/{id}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"description": "string",
"isActive": true
}'Token updated
Token
Metadata of the token, this is optional and can be null in case of Point token
this is the abi of the contract, this is the interface of the contract to interact with it
this is the url of the abi of the contract, to be used to fetch the abi of the contract
this is the decimals of the token. This is optional and only used for ERC20 tokens (Points)
Purchase Type
{ "id": "string", "description": "string", "token": { "id": "string", "contractAddress": "string", "metadata": {}, "abi": {}, "chainId": 0, "abiUrl": {}, "name": "string", "symbol": "string", "decimals": 0, "isActive": true, "isGallery": true, "type": "ERC20" }, "contractTokenId": {}, "purchaseType": { "conversionRate": 0, "currency": "eur", "id": 0 }, "isActive": true }
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/admin/token/{id}
https://explorins-loyalty.ngrok.io/purchase/admin/token/{id}
https://api.pers.ninja/v1.8/purchase/admin/token/{id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://docs.pers.ninja/_mock/swagger/purchase/admin/token/{id}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/admin/type
https://explorins-loyalty.ngrok.io/purchase/admin/type
https://api.pers.ninja/v1.8/purchase/admin/type
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.pers.ninja/_mock/swagger/purchase/admin/type \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"conversionRate": 0,
"currency": "eur"
}'{ "conversionRate": 0, "currency": "eur" }
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/admin/donation/type
https://explorins-loyalty.ngrok.io/purchase/admin/donation/type
https://api.pers.ninja/v1.8/purchase/admin/donation/type
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.pers.ninja/_mock/swagger/purchase/admin/donation/type \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"percentage": 0,
"id": 0
}'{ "percentage": 0, "id": 0 }
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/donation/type
https://explorins-loyalty.ngrok.io/purchase/donation/type
https://api.pers.ninja/v1.8/purchase/donation/type
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://docs.pers.ninja/_mock/swagger/purchase/donation/type \
-H 'x-project-key: YOUR_API_KEY_HERE'[ { "percentage": 0, "id": 0 } ]
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/token
https://explorins-loyalty.ngrok.io/purchase/token
https://api.pers.ninja/v1.8/purchase/token
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.pers.ninja/_mock/swagger/purchase/token?active=string' \
-H 'x-project-key: YOUR_API_KEY_HERE'Active Purchase Tokens
Token
Metadata of the token, this is optional and can be null in case of Point token
this is the abi of the contract, this is the interface of the contract to interact with it
this is the url of the abi of the contract, to be used to fetch the abi of the contract
this is the decimals of the token. This is optional and only used for ERC20 tokens (Points)
Purchase Type
[ { "id": "string", "description": "string", "token": { … }, "contractTokenId": {}, "purchaseType": { … }, "isActive": true } ]
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/auth
https://explorins-loyalty.ngrok.io/purchase/auth
https://api.pers.ninja/v1.8/purchase/auth
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.pers.ninja/_mock/swagger/purchase/auth \
-H 'Content-Type: application/json' \
-H 'x-project-key: YOUR_API_KEY_HERE' \
-d '{
"quantity": 0,
"paymentIntentId": "string",
"purchaseTokenId": "string",
"donationTypeId": 0,
"donationAccountAddress": "string"
}'Purchase Created
Purchase Token
Token
Metadata of the token, this is optional and can be null in case of Point token
this is the abi of the contract, this is the interface of the contract to interact with it
this is the chain id of the chain where the token is deployed
this is the url of the abi of the contract, to be used to fetch the abi of the contract
this is the symbol of the token contract, this is optional and can be null
this is the decimals of the token. This is optional and only used for ERC20 tokens (Points)
This can be used to enable or disable the token for gallery
Purchase Type
User
Business
The id of the business, this is unique and will be used to identify the business.
The email of the business, this is unique and will be used to identify the business.
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 website of the business, this is the website that will be shown to the public.
The image of the business, this is the image 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", "stripePaymentIntentId": "string", "status": {}, "amount": 0, "currency": "eur", "quantity": 0, "purchaseToken": { "id": "string", "description": "string", "token": { … }, "contractTokenId": {}, "purchaseType": { … }, "isActive": true }, "user": { "id": "string", "email": {}, "firstName": {}, "lastName": {}, "externalId": {}, "accountAddress": "string", "instagramAccountId": {}, "googleAccountName": {}, "customData": {}, "publicProfile": {}, "isActive": true }, "business": { "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": { … }, "isActive": true, "canMintToken": true, "canChargeToken": true, "canManageUsers": true, "canReceiveDonation": true }, "donationAccountAddress": "string", "donationType": { "percentage": 0, "id": 0 }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "paymentClientSecret": {} }
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/auth
https://explorins-loyalty.ngrok.io/purchase/auth
https://api.pers.ninja/v1.8/purchase/auth
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://docs.pers.ninja/_mock/swagger/purchase/auth \
-H 'x-project-key: YOUR_API_KEY_HERE'Purchase found
Purchase Token
Token
Metadata of the token, this is optional and can be null in case of Point token
this is the abi of the contract, this is the interface of the contract to interact with it
this is the chain id of the chain where the token is deployed
this is the url of the abi of the contract, to be used to fetch the abi of the contract
this is the symbol of the token contract, this is optional and can be null
this is the decimals of the token. This is optional and only used for ERC20 tokens (Points)
This can be used to enable or disable the token for gallery
Purchase Type
User
Business
The id of the business, this is unique and will be used to identify the business.
The email of the business, this is unique and will be used to identify the business.
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 website of the business, this is the website that will be shown to the public.
The image of the business, this is the image 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", "stripePaymentIntentId": "string", "status": {}, "amount": 0, "currency": "eur", "quantity": 0, "purchaseToken": { … }, "user": { … }, "business": { … }, "donationAccountAddress": "string", "donationType": { … }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" } ]
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/payment-intent
https://explorins-loyalty.ngrok.io/purchase/payment-intent
https://api.pers.ninja/v1.8/purchase/payment-intent
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.pers.ninja/_mock/swagger/purchase/payment-intent \
-H 'Content-Type: application/json' \
-H 'x-project-key: YOUR_API_KEY_HERE' \
-d '{
"amount": 0,
"currency": "string",
"receiptEmail": "string",
"description": "string"
}'{ "paymentClientSecret": {}, "paymentIntentId": "string" }
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/payment-intent/{paymentIntentId}
https://explorins-loyalty.ngrok.io/purchase/payment-intent/{paymentIntentId}
https://api.pers.ninja/v1.8/purchase/payment-intent/{paymentIntentId}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
'https://docs.pers.ninja/_mock/swagger/purchase/payment-intent/{paymentIntentId}' \
-H 'Content-Type: application/json' \
-H 'x-project-key: YOUR_API_KEY_HERE' \
-d '{
"amount": 0,
"currency": "string",
"receiptEmail": "string",
"description": "string"
}'{ "paymentClientSecret": {}, "paymentIntentId": "string" }
- Mock server
https://docs.pers.ninja/_mock/swagger/purchase/payment-intent/{paymentIntentId}
https://explorins-loyalty.ngrok.io/purchase/payment-intent/{paymentIntentId}
https://api.pers.ninja/v1.8/purchase/payment-intent/{paymentIntentId}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://docs.pers.ninja/_mock/swagger/purchase/payment-intent/{paymentIntentId}' \
-H 'x-project-key: YOUR_API_KEY_HERE'{ "paymentClientSecret": {}, "paymentIntentId": "string" }