Connect your app
to the BB84 Wallet

🧩 Wallet connectors (read-only user data)

Ask a BB84 Wallet user for read-only access to their profile, balances and transactions. The user approves the request in the app under Settings → Connectors and can disconnect at any time. Access tokens can only read: there are no endpoints that move funds or change anything.

1. Create a request

curl -X POST https://bb84.com/api/connect/requests \
  -H "Content-Type: application/json" \
  -d '{"appName":"My App","appUrl":"https://myapp.example","scopes":["profile","balances","transactions"]}'

# {"requestId":"…","code":"K7QM2XPA","pollToken":"bb84_poll_…","connectUrl":"bb84://connect/K7QM2XPA","expiresAt":…}

Show the user the code (they type it into the app) or open connectUrl on their phone. Requests expire after 10 minutes. The wallet shows your appName and appUrl to the user — they are self-declared, so users decide whom to trust.

2. Wait for approval

curl https://bb84.com/api/connect/requests/REQUEST_ID/status \
  -H "Authorization: Bearer bb84_poll_…"

# {"status":"pending"} · {"status":"rejected"} · {"status":"expired"}
# {"status":"approved","accessToken":"bb84_conn_…"}   ← returned once, store it securely

3. Read data

curl https://bb84.com/api/connect/v1/balances \
  -H "Authorization: Bearer bb84_conn_…"