# Dashboard Settings

Configure your merchant account settings in the dashboard.

# Accessing Settings

Log in to the Dashboard
Click the Settings icon in the sidebar
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 all payments (minus fees)
	Must be a valid Hive account

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:

Navigate to Settings
Find the Webhook Secret section
Click Regenerate Secret
Confirm the action in the warning dialog
Copy the new secret immediately - it won't be shown again
Update your application with the new secret

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

Enter your webhook URL
Click Test Webhook
Check your server logs for the test payload

See the Webhooks documentation 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:

Contact support
Your old key will be immediately deactivated
You'll receive a new API key
Update your applications with the new key

Cannot Undo

Regenerating an API key immediately invalidates the old key. Any applications using the old key will stop working.

# Updating Settings

# Via Dashboard

Navigate to Settings
Edit the fields you want to change
Click Save Changes
Confirmation message appears on success

# Via API

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 -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

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