# CommercioAPI Flows example
These flows are provided solely as examples and may be used as starting points for further development.
It is assumed that an external software is in place to handle the logic and sequence of events, as well as to control access to the API.
In the examples, this software stack is referred to as the 'Client App', which could be either a mobile or web application supported by a backend
# Edelivery process with sharedoc and Receipt
In Review - cooming soon
# User invitation with document notarization
In Review - cooming soon
# User invitation with Spid recognition and request for document notarization
Suppose the target is to provide a function within the Client App
that enables users to notarize a document to an existing eID, (suppose an administration's wallet address), while being authenticated through their email account in the Client App
.
In addition, the user must be authenticated via a SPID process before they can notarize the document. This is necessary to retrieve the user's authentication private data from SPID within the Client App
and store it in the backend for user identification purposes.
Thus the premisis are : An administration account, referred to as the administration account
, already exists in commercio.app. Additionally, the user is authenticated within the 'Client App' using the email user001@email.com.
# Sequence of the workflow
The
Client App
present to the user an accreditation page asking to choose between two options- a) New user process: Start commercio.app onboarding
- b) Registered user process: Enter commercio.app password of the user as registered user in commercio.app
The Client App
uses the Invite user api loggin in with administrator account already present in commercio.app
If the user doesn't exist the Api will reply with an invitaition process Body response and the user will receive an invitation email to commercio.app starting New user workflow othervise the Api will reply with a wallet address and the Client App
will notify the user to enter his credentials ad start the Registered user workflow
# Workflow a) New user
- The user perform through an external browser the step expected by the invitation process (Not Existing user)
- The
Client App
check the API KYC Verify Credentials loggin in with administrator account already present in commercio.app until"audit": "public_digital_identity_system"
alternatively in theClient App
present to the user an incomplete status message
- The
- Once the
Client App
veryfy that thepublic_digital_identity_system
it propose to enter the commercio account password in order to be used for log in the API service with the user credentials
- Once the
- Using with the user account the API KYC Verify Credentials the body response will reply with the
public_digital_identity_system
elementcontent
filled. It must be Base 64 decoded and then sent to the backend of theClient App
thus registering al the identification data of the user
- Using with the user account the API KYC Verify Credentials the body response will reply with the
Appropriete warning for exchanging personal data with the Client App
app must be presented to the user and must be accepted. Is appropriate to register an audit of this acceptance and than make a sharedoc of the file containing the audit
- At this point could be presented to the user the interface to istantiate a sharedoc message process Send a shareDOc Message from user wallet address to the one of the administrator notarizing the hash of the document the app want to notarize in the Blockchain
# Workflow b) Registered user
As registered user the process is similar to the previous one except from the fact that after asking the user to enter his password of the commercio.app this workflow start from point 3.
# User request for pades like signatureand notarization
In Review - cooming soon