Public profile
Your Business Wallet has one public profile: the identity other parties see when you share credentials or expose service endpoints. It holds your organisation's logo, name, contact details, and address, and it can also carry credentials you have chosen to publish.
Publishing a credential on the profile is how you prove something about your organisation without being asked first. A contact who looks up your identifier finds, for example, your Chamber of Commerce registration already attached to it.
You need the Public wallet profile (View) permission to open the profile, and Public wallet profile (Change) to edit it or to publish and remove credentials. See Roles.
How to access
- Open the left sidebar.
- Under Holder, click Public profile.
The screen has three sections:
- Profile information: your identifier and the contact details you publish.
- Credentials: the credentials you have chosen to publish on the profile.
- Services: the service endpoints exposed by your default identifier.
As long as nothing is published, the Credentials and Services sections show an empty state with an Add credential and an Add service button.
Profile information
Key elements:
- Identifier: the identifier of your wallet that carries the profile. Use the copy icon to copy it, or the link icon to open the published identifier document that other parties fetch.
- Address: street, postal code, city, and country.
- Phone: the phone number contacts can reach you on.
- Email: shown as a mail link.
- Website: shown as a link that opens in a new tab.
Only the fields you filled in are shown. Empty fields are left out of the profile.
The profile is meant to be read by other parties. Do not put anything in these fields that you would not publish on your own website.
Edit the profile
- Click Edit information at the top right.
- Update the fields you want to change.
- Click Save.
The form is split into three sections:
Identity
- Change image: upload the logo shown next to your organisation name. Click the logo to pick a new image.
- Organization name (required): the name contacts see. This is also the name shown in the header of your wallet.
- Website: must start with
http://orhttps://.
Contact information
- Phone number
- Email: must be a valid email address.
Address
- Street
- Postal code and City
- Country
While you have unsaved changes, the bar at the bottom shows You have unsaved changes. Click Cancel to discard them, or Save to publish them.
Publish a credential on the profile
- In the Credentials section, click Add credential.
- Pick the credential you want to publish.
The list shows the credentials in your wallet that are held by your profile identifier, each with its status. Use Search credentials to narrow the list down.
- Choose which details to share. Every attribute with a checkbox in front of it is optional: tick the box to publish that attribute, leave it unticked to keep it private.
- Click Add to public profile.
You return to the profile, where the credential now appears in the Credentials section. Click a credential to expand it and see exactly which attributes are published.
Only credentials that support selective disclosure show checkboxes. For other credentials all details are published as they are, so publish such a credential only if you are comfortable sharing all of it.
You can also publish straight from a credential: open it from Wallet, and click Add to public profile on the credential detail screen. The button only appears for credentials that may be published.
Remove a credential from the profile
- Click the credential in the Credentials section to expand it.
- Click Delete.
- Confirm with Yes.
The credential stays in your wallet. Only its publication on the profile is withdrawn, so other parties can no longer read it there.
Services
The Services section lists the service endpoints published by your default identifier, for example an endpoint used for communication or credential exchange. Click Add service to manage them on the identifier itself. Published credentials are exposed as an endpoint on that same identifier, which is how other parties can read them.
Manage the profile from your backend
The profile fields are also available through the API, so you can keep them in sync with your own systems. All three endpoints work on one wallet, identified by its external key.
| Endpoint | What it does |
|---|---|
| Get public profile | Returns the current profile, including the wallet's external key. |
| Update public profile | Replaces all profile fields. Fields you leave out are cleared. |
| Partially update public profile | Updates only the fields you send and leaves the rest untouched. |
The writable fields are displayName (required on a full update), logo, website, phoneNumber, email, addressStreet, addressPostalCode, addressCity, addressCountry, geoLocationLatitude, and geoLocationLongitude. The logo accepts either a URL, which is fetched and stored, or a base64 data URI.
Reading a profile requires the Public wallet profile (View) permission, writing it requires Public wallet profile (Change).
Every successful update, through either endpoint, emits the com.credenco.businesswallet.publicprofile.updated.v1 event with a full snapshot of the profile. See the Event catalog if you want to react to profile changes.
Notes and limitations
- Credentials are published and removed from the UI only. The API covers the profile fields, not the published credentials.
- The geo location fields are available through the API but are not shown in the UI.
- Changing the Organization name changes the name shown throughout your wallet, not only on the public profile.