# Dashboard Settings

Configure your merchant account settings in the dashboard.

---

## Accessing Settings

1. Log in to the [Dashboard](https://dashboard.hivepay.me)
2. Click the **Settings** icon in the sidebar
3. Or navigate to `/settings`

---

## Profile Settings

### Business Name

Your business name is displayed to customers during checkout.

| Field | Description |
|-------|-------------|
| Name | Your business or store name |
| | Displayed on checkout page |
| | Max 100 characters |

### Hive Account

The Hive account where payments are sent.

| Field | Description |
|-------|-------------|
| Hive Account | Your Hive username |
| | Receives the full payment amount (HivePay bills monthly — see [Billing](/payments/fees/)) |
| | Must be a valid Hive account |

!!!warning Important
Changing your Hive account affects all future payments. Pending payments will still be sent to the previously configured account.
!!!

### Icon/Logo

Add a logo to display on checkout pages:

| Field | Description |
|-------|-------------|
| Icon URL | HTTPS URL to your logo image |
| | Recommended: 256x256px or larger |
| | Supported: PNG, JPG, SVG |

---

## Webhook Settings

Configure webhooks to receive real-time payment notifications.

### Webhook URL

| Field | Description |
|-------|-------------|
| Webhook URL | HTTPS endpoint on your server |
| | Receives POST requests |
| | Must respond with 2xx status |

### Webhook Secret

Your webhook secret (`whsec_xxx`) is used to verify webhook signatures. It is separate from your API key.

- The secret is shown once during registration or after regeneration
- You can regenerate it at any time from the Settings page

### Regenerate Webhook Secret

If your webhook secret is compromised:

1. Navigate to **Settings**
2. Find the **Webhook Secret** section
3. Click **Regenerate Secret**
4. Confirm the action in the warning dialog
5. **Copy the new secret immediately** - it won't be shown again
6. Update your application with the new secret

!!!danger Cannot Undo
Regenerating the webhook secret immediately invalidates the previous one. Any integrations using the old secret will fail to verify webhook signatures.
!!!

### Testing Webhooks

1. Enter your webhook URL
2. Click **Test Webhook**
3. Check your server logs for the test payload

See the [Webhooks documentation](/payments/webhooks/) for implementation details.

---

## API Key Management

### View API Key Info

The settings page shows:
- Partial API key (last 4 characters)
- Creation date
- Last used timestamp

### Regenerate API Key

If you need a new API key:

1. Contact [support](/support/)
2. Your old key will be immediately deactivated
3. You'll receive a new API key
4. Update your applications with the new key

!!!danger Cannot Undo
Regenerating an API key immediately invalidates the old key. Any applications using the old key will stop working.
!!!

---

## Updating Settings

### Via Dashboard

1. Navigate to Settings
2. Edit the fields you want to change
3. Click **Save Changes**
4. Confirmation message appears on success

### Via API

+++ TypeScript
```typescript
const updated = await hivepay.merchants.update('your_merchant_id', {
  iconUrl: 'https://example.com/new-logo.png',
  webhookUrl: 'https://example.com/webhooks/hivepay',
  hiveAccount: 'newaccount'
});
```
+++ cURL
```bash
curl -X PUT https://hivepay.me/api/public/merchants/your_merchant_id \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "iconUrl": "https://example.com/new-logo.png",
    "webhookUrl": "https://example.com/webhooks/hivepay"
  }'
```
+++

---

## Notification Preferences

Coming soon:
- Email notifications for large payments
- Daily/weekly summary emails
- Alert thresholds

---

## Best Practices

1. **Use HTTPS** for webhook URLs
2. **Test webhooks** before going live
3. **Keep your logo URL stable** - changing it affects checkout appearance
4. **Document your settings** - keep a record of your configuration