Settings

Account settings management. All endpoints require authentication.

GET /settings/me

Get the current user's settings.

curl https://api.paylinks.ro/api/v1/settings/me \
  -H "Authorization: Bearer YOUR_TOKEN"

Response (200):

{
  "settings": {
    "id": "cm7v42c9y0002rj0r0lq3m4w5",
    "userId": "cm7v3k5h300001z3s4b2n7q9d",
    "autoPayouts": false,
    "payoutInterval": "manual",
    "emailNotifications": true,
    "marketingEmails": true,
    "bankIban": "RO49AAAA1B31007593840000",
    "bankAccountName": "Andrei Bucur",
    "bankName": "Banca Exemplu",
    "createdAt": "2026-02-01T09:00:00.000Z",
    "updatedAt": "2026-02-16T13:00:00.000Z"
  }
}

---

PUT /settings/me

Update account settings.

curl -X PUT https://api.paylinks.ro/api/v1/settings/me \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "autoPayouts": true,
    "payoutInterval": "weekly",
    "emailNotifications": true,
    "bankIban": "RO49AAAA1B31007593840000",
    "bankAccountName": "Andrei Bucur",
    "bankName": "Banca Exemplu"
  }'

Request Body:

Field	Type	Required	Description
autoPayouts	boolean	No	Enable or disable automatic payouts
payoutInterval	string	No	daily, weekly, monthly, or manual
emailNotifications	boolean	No	Receive transactional notifications
bankIban	string	No	Bank IBAN
bankAccountName	string	No	Account holder name
bankName	string	No	Bank name

Response (200):

{
  "settings": {
    "id": "cm7v42c9y0002rj0r0lq3m4w5",
    "userId": "cm7v3k5h300001z3s4b2n7q9d",
    "autoPayouts": true,
    "payoutInterval": "weekly",
    "emailNotifications": true,
    "marketingEmails": true,
    "bankIban": "RO49AAAA1B31007593840000",
    "bankAccountName": "Andrei Bucur",
    "bankName": "Banca Exemplu",
    "createdAt": "2026-02-01T09:00:00.000Z",
    "updatedAt": "2026-02-17T11:00:00.000Z"
  }
}

---

PUT /settings/me/name

Update display name.

curl -X PUT https://api.paylinks.ro/api/v1/settings/me/name \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Andrei Bucur"}'

Request Body:

Field	Type	Required	Description
name	string	Yes	Display name (1-64 chars, letters/spaces/'/-)

Response (200):

{
  "ok": true,
  "user": {
    "id": "cm7v3k5h300001z3s4b2n7q9d",
    "email": "[email protected]",
    "name": "Andrei Bucur"
  }
}