# Support

Get help with HivePay integration and troubleshooting.

---

## Contact Us

### Discord

Join our Discord community for:
- Real-time help from the team and community
- Feature discussions and announcements
- Integration tips and best practices

[!button icon="comment" text="Join Discord" variant="primary"](https://discord.gg/YOUR_INVITE_CODE)

!!!info Update Required
Replace `YOUR_INVITE_CODE` with your actual Discord invite link.
!!!

---

### Email Support

For private inquiries, security issues, or account-related questions:

**support@hivepay.me**

We aim to respond within 24-48 hours on business days.

!!!info Update Required
Replace with your actual support email address.
!!!

---

## Self-Help Resources

### Documentation

- [Getting Started](/getting-started/) - New to HivePay? Start here
- [Payment Integration](/payments/) - Create and manage payments
- [SDK Reference](/sdk/) - TypeScript client library
- [Dashboard Guide](/dashboard/) - Merchant dashboard usage

### API Reference

- [OpenAPI Specification](https://hivepay.me/openapi.json) - Full API documentation
- [Error Codes](/sdk/errors/) - Understanding error responses

---

## Common Issues

### Authentication Errors

**Symptom:** `401 Unauthorized` or `AUTHENTICATION_ERROR`

**Solutions:**
1. Verify your API key is correct
2. Check the API key hasn't been regenerated
3. Ensure the `Authorization` header is formatted correctly: `Bearer sk_live_xxx`

### Webhook Not Received

**Symptom:** Your webhook endpoint isn't receiving notifications

**Solutions:**
1. Verify webhook URL is configured in [Settings](/dashboard/settings/)
2. Ensure URL is HTTPS and publicly accessible
3. Check your server logs for incoming requests
4. Test with local webhook server: `pnpm test:webhook`

### AML Limit Reached

**Symptom:** `403 Forbidden` with message `AML limit reached. Please contact us at aml@hivepay.me to perform KYC verification process.`

**Cause:** Your merchant account has been flagged because a single transaction or your cumulative payment volume within a short timeframe exceeded AML thresholds.

**Solutions:**
1. Email **aml@hivepay.me** with your merchant account details
2. Complete the KYC verification process
3. Once verified, payment creation will resume automatically

### Payment Not Completing

**Symptom:** Payment stuck in `pending` or `processing`

**Solutions:**
1. Verify the Hive transaction was submitted
2. Check blockchain explorers for transaction status
3. Wait for blockchain confirmation (typically 3 seconds)
4. Contact support if issue persists

### SDK Installation Issues

**Symptom:** Cannot import `@hivepay/client`

**Solutions:**
1. Verify Node.js version is 18+
2. Run `pnpm install` to ensure dependencies are installed
3. Check for conflicting package versions

---

## Reporting Bugs

Found a bug? Report it on GitHub:

[!button icon="mark-github" text="Report Bug"](https://github.com/hivepayment/hivepay/issues/new)

Please include:
- Steps to reproduce
- Expected vs actual behavior
- SDK version
- Node.js version
- Relevant code snippets

---

## Feature Requests

Have an idea for HivePay? We'd love to hear it:

[!button icon="light-bulb" text="Request Feature"](https://github.com/hivepayment/hivepay/issues/new?labels=enhancement)

---

## System Status

Check current system status and planned maintenance:

[!ref icon="pulse" text="System Status"](/support/status/)

---

## Business Inquiries

For partnerships, enterprise pricing, or custom integrations:

**business@hivepay.me**

!!!info Update Required
Replace with your actual business email address.
!!!
