> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xerobi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart Guide

> Get started with Xerobi APIs in minutes

## Welcome to Xerobi APIs

Get up and running with Xerobi's Payment Gateway, SMS Gateway, or Certification & Badge APIs in just a few steps.

## Step 1: Get Your API Keys

**1. Sign up for a Xerobi account**

Visit [dash.hixbe.com](https://dash.hixbe.com) and create your account. Choose the APIs you need (Payment, SMS, or Certification).

**2. Generate API keys**

1. Go to your dashboard
2. Navigate to API Keys section
3. Create a new API key with appropriate permissions
4. Copy your secret key (keep it secure!)

> [!WARNING]
>
> **Never share your API keys publicly.** Store them securely and rotate them regularly.

## Step 2: Make Your First API Call

**1. Set up authentication**

All Xerobi API requests require authentication using Bearer tokens and API versioning. Learn more about [authentication](https://docs.xerobi.com/faq-guides/authentication.md) and [API versioning](https://docs.xerobi.com/faq-guides/versioning.md).

```bash theme={null}
curl -X GET "https://api.hixbe.com/payment/payment_intents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Xerobi-Version: 2026-01-01" \
  -H "Content-Type: application/json"
```

**2. Choose your API**

> [card] [Payment Gateway](https://docs.xerobi.com/payment-api/introduction.md)
>
> Process payments, manage customers, handle refunds

> [card] [SMS Gateway](https://docs.xerobi.com/sms-api/introduction.md)
>
> Send SMS messages globally with delivery tracking

> [card] [Certification & Badge](https://docs.xerobi.com/certify-api/introduction)
>
> Issue and verify digital credentials and badges

**3. Test with sample data**

Use our sandbox environment for testing:

```bash theme={null}
# Use sandbox base URL for testing
curl -X POST "https://sandbox.api.hixbe.com/payment/payment_intents" \
  -H "Authorization: Bearer YOUR_SANDBOX_KEY" \
  -H "Xerobi-Version: 2026-01-01" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "currency": "USD",
    "description": "Test payment"
  }'
```

## Step 3: Handle Responses

**1. Parse API responses**

All APIs return JSON responses with consistent error handling:

```json theme={null}
{
  "success": true,
  "data": {
    "id": "pi_1234567890",
    "amount": 1000,
    "currency": "USD",
    "status": "succeeded"
  }
}
```

**2. Handle errors gracefully**

```json theme={null}
{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The request is missing required parameters",
    "details": {
      "missing_fields": ["amount"]
    }
  }
}
```

## Step 4: Go Live

**1. Switch to production**

Replace sandbox URLs with production URLs:

* Sandbox: `https://sandbox.api.hixbe.com`
* Production: `https://api.hixbe.com`

**2. Monitor your integration**

Use [webhooks](https://docs.xerobi.com/faq-guides/webhooks.md) to receive real-time updates about payment status, SMS delivery, or credential changes.

## Next Steps

> [card] [Authentication Guide](https://docs.xerobi.com/faq-guides/authentication.md)
>
> Learn about API keys, OAuth, and security best practices

> [card] [API Versioning](https://docs.xerobi.com/faq-guides/versioning.md)
>
> Understand how Xerobi handles API versioning

> [card] [Webhooks](https://docs.xerobi.com/faq-guides/webhooks.md)
>
> Set up real-time notifications for your application

> [card] [Error Handling](https://docs.xerobi.com/faq-guides/error-handling.md)
>
> Handle API errors and implement retry logic

> [!NOTE]
>
> **Need help?** Check our [troubleshooting guide](https://docs.xerobi.com/faq-guides/troubleshooting) or contact [support@xerobi.com](mailto:support@xerobi.com).


## Related topics

- [Xerobi Payment API Introduction](https://docs.xerobi.com/payment-api/introduction.md)
- [Xerobi Certification & Badge API Introduction](https://docs.xerobi.com/certify/introduction.md)
- [Xerobi SMS Gateway API Introduction](https://docs.xerobi.com/sms-api/introduction.md)
- [Best Practices](https://docs.xerobi.com/faq-guides/best-practices.md)
- [Xerobi Developer Documentation](https://docs.xerobi.com/index.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.