Docs
Powered by

Dashboard Settings

Configure your merchant account settings in the dashboard.

Accessing Settings

  1. Log in to the Dashboard
  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)
  Must be a valid Hive account

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

Testing Webhooks

  1. Enter your webhook URL
  2. Click Test Webhook
  3. 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:

  1. Contact 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

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

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

  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

HivePay © 2026