Participant profile

Endpoint	What it does
GET /v1/auth/wallet/me	Returns the authenticated participant's global profile.
PATCH /v1/auth/wallet/me	Updates displayName and/or preferredLocale.

Same profile data shape as the management profile (displayName, email, phone, phoneStatus, status, preferredLocale, profileComplete, createdAt/updatedAt) — but only accepts a token with principal_type=user. Against a management, PDV, or cashier token, it responds 401 AUTHENTICATION_PROFILE_MISMATCH.

Read-only fields here: email (a participant doesn't have one, they sign in by phone), phone, phoneStatus. Only displayName and preferredLocale are editable by the participant themselves.

Example: filling in the name after the first OTP

curl

curl -X PATCH http://127.0.0.1:8787/v1/auth/wallet/me \
  -H "Authorization: Bearer <accessToken>" \
  -H "Content-Type: application/json" \
  -d '{ "displayName": "Maria Silva" }'

JavaScript

const response = await fetch("http://127.0.0.1:8787/v1/auth/wallet/me", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ displayName: "Maria Silva" }),
});
const profile = await response.json();

Python

import requests

response = requests.patch(
    "http://127.0.0.1:8787/v1/auth/wallet/me",
    headers={"Authorization": f"Bearer {access_token}"},
    json={"displayName": "Maria Silva"},
)
profile = response.json()