Onboard New Users/Customers

POST /v1/trovo-api/users/onboard

Onboarding a user creates a trovo app profile and a default primary wallet, whose wallet address is the public key parameter you submitted and then the wallet alias is the username that is generated by the trovo api and returned as response. Both the username which is the default wallet alias, and the public key can be used to receive payment from within the trovo app ecosystem. Sending the public key in a transaction may automatically translate to the username and the username will be used for the transaction. A message will be returned to notify the user of the subtle translation. However, for all header parameters, the public key must be specified. For receiving transactions outside of the trovo app ecosystem, the public key must be used. This includes any transaction on the Bantu Blockchain network.

Json Body

{
    Email                  string `json:"email"`
    FirstName              string `json:"firstName"` //firstname, or company when corporate = 1
   *  LastName             string `json:"lastName"` //optional, which is valid for when corporate = 1
    Mobile                 string `json:"mobile"`
    MobileCountryCode      string `json:"mobileCountryCode"`
    PublicKey              string `json:"publicKey"` //public key of the wallet you intend to tie to the profile.
    PrimarySigner          string `json:"primarySigner"` //public key of the secret key. If the wallet is not a recovered wallet that has been recovered through wallet recovery, then this is the public key of the profile.
   * Referrer              string `json:"referrer"`
    Corporate              uint   `json:"corporate"` //default is 0 = individual
}

* = Optional parameters.

HEADERS REQUIRED: X-TW-SERVICE-LINK-API-KEY

Json Response

{
	Username               string `json:"username"` //generated username assigned to the profile.
	Email                  string `json:"email"`
	FirstName              string `json:"firstName"`
	LastName               string `json:"lastName"`
	Mobile                 string `json:"mobile"`
	MobileCountryCode      string `json:"mobileCountryCode"`
	PublicKey              string `json:"publicKey"` //public key of the wallet you intend to tie to the profile. See how to get a new keypair
	PrimarySigner          string `json:"primarySigner"` //public key of the secret key. If the wallet is not a recovered wallet that has been recovered through wallet recovery, then this is the public key of the profile. Always use same value as PublicKey above, unless wallet recovery has happened on the wallet, then you use the public key opf the new signer.

	Referrer               string `json:"referrer"`
	Corporate              uint   `json:"corporate"`
}

See how to get a new keypair

CODE: 200 OK or error