# 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

# 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