# Merchant Registration

# Web Registration

The easiest way to register is through the HivePay Dashboard:

Navigate to dashboard.hivepay.me/register
Fill in your merchant details:
- Name - Your business or store name (displayed to customers)
- Hive Account - Your Hive username (where payments will be sent)
- Icon URL (optional) - A URL to your logo image
Click Register
Save your API key immediately - it's shown only once!

Important

Your API key is displayed only once after registration. Copy and store it securely before leaving the page. If you lose it, you'll need to contact support.

# Programmatic Registration

You can also register programmatically using the API or SDK:

import { HivePay } from '@hivepay/client';

// No API key needed for registration
const publicClient = new HivePay();

const result = await publicClient.merchants.register({
  name: 'My Store',
  hiveAccount: 'mystore',
  iconUrl: 'https://example.com/logo.png'  // optional
});

// IMPORTANT: Save this API key securely!
console.log('API Key:', result.apiKey);
console.log('Merchant ID:', result.merchant.id);

// Create authenticated client for future requests
const hivepay = publicClient.withApiKey(result.apiKey);

curl -X POST https://hivepay.me/api/public/merchants/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Store",
    "hiveAccount": "mystore",
    "iconUrl": "https://example.com/logo.png"
  }'

Response:

{
  "apiKey": "sk_live_xxxxxxxxxxxxx",
  "merchant": {
    "id": "cmkfgjmim00008rcxp81upef9",
    "name": "My Store",
    "hiveAccount": "mystore",
    "isActive": true,
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
}

# Registration Fields

Field	Required	Description
`name`	Yes	Business name displayed to customers during checkout
`hiveAccount`	Yes	Your Hive blockchain username for receiving payments
`iconUrl`	No	URL to your logo (displayed on checkout page)

# After Registration

Once registered, you can:

Configure authentication for API access
Set up webhooks to receive payment notifications
Create your first payment

# Account Verification

New merchant accounts are active immediately. However, for high-volume processing or certain features, additional verification may be required. Contact support if you need to increase your processing limits.