Skip to main content

​
Welcome to Hixbe APIs

Get up and running with Hixbe’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 Hixbe account

Visit 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!)
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 Hixbe API requests require authentication using Bearer tokens and API versioning. Learn more about authentication and API versioning.
curl -X GET "https://api.hixbe.com/payment/payment_intents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Hixbe-Version: 2026-01-01" \
  -H "Content-Type: application/json"
2

Choose your API

Payment Gateway

Process payments, manage customers, handle refunds

SMS Gateway

Send SMS messages globally with delivery tracking

Certification & Badge

Issue and verify digital credentials and badges
3

Test with sample data

Use our sandbox environment for testing:
# Use sandbox base URL for testing
curl -X POST "https://sandbox.api.hixbe.com/payment/payment_intents" \
  -H "Authorization: Bearer YOUR_SANDBOX_KEY" \
  -H "Hixbe-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:
{
  "success": true,
  "data": {
    "id": "pi_1234567890",
    "amount": 1000,
    "currency": "USD",
    "status": "succeeded"
  }
}
2

Handle errors gracefully

{
  "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 to receive real-time updates about payment status, SMS delivery, or credential changes.

​
Next Steps

Authentication Guide

Learn about API keys, OAuth, and security best practices

API Versioning

Understand how Hixbe handles API versioning

Webhooks

Set up real-time notifications for your application

Error Handling

Handle API errors and implement retry logic
Need help? Check our troubleshooting guide or contact support@hixbe.com.