# Merchant Registration

Register as a HivePay merchant to start accepting HIVE and HBD payments.

---

## Web Registration

The easiest way to register is through the [HivePay Dashboard](https://dashboard.hivepay.me/register):

1. Navigate to [dashboard.hivepay.me/register](https://dashboard.hivepay.me/register)
2. 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
3. Click **Register**
4. **Save your API key and webhook secret immediately** - they're shown only once!

!!!warning Important
Your API key and webhook secret are displayed only once after registration. Copy and store both securely before leaving the page. If you lose the API key, you'll need to contact support. The webhook secret can be regenerated in [Dashboard settings](/dashboard/settings/).
!!!

---

## Programmatic Registration

You can also register programmatically using the API or SDK:

+++ TypeScript
```typescript
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 these credentials securely!
console.log('API Key:', result.apiKey);
console.log('Webhook Secret:', result.webhookSecret);
console.log('Merchant ID:', result.merchant.id);

// Create authenticated client for future requests
const hivepay = publicClient.withApiKey(result.apiKey);
```
+++ cURL
```bash
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:
```json
{
  "apiKey": "sk_live_xxxxxxxxxxxxx",
  "webhookSecret": "whsec_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:

1. [Configure authentication](/getting-started/authentication/) for API access
2. [Set up webhooks](/payments/webhooks/) to receive payment notifications
3. [Create your first payment](/payments/creating/)

---

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