Associate a referral code with the authenticated account
Records attribution for a referral code against the authenticated wallet. The request body contains only the referral code; wallet and account identity are resolved from the Bearer session by the platform BFF.
The endpoint is idempotent per wallet: if the wallet already has a
referral attribution, it returns associated: true with already: true
and does not write a second redemption row.
POST
Associate a referral code with the authenticated account
Authorizations
JWT obtained from POST /v1/auth/verify after SIWS authentication.
Include as: Authorization: Bearer <jwt>
Body
application/json
Referral code to associate with the authenticated wallet.
Example:
"ALICE"
Response
Referral association recorded or already present
Associate a referral code with the authenticated account