Developer API

Bitcoin Payments
In Just 5 Lines of Code

Aurora's RESTful API lets you integrate Bitcoin and Lightning Network payments into your application with minimal effort.

Bitcoin & Lightning

Webhook Events

aurora-api.py

import requests

# Create a Lightning invoice
def create_invoice(api_key, amount, memo):
    url = "https://aurora.mybuho.de/api/invoice"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    payload = {
        "amount": amount,
        "memo": memo,
        "currency": "currency code",
        "extra": {}
    }
    
    response = requests.post(url, headers=headers, json=payload)
    return response.json()

# Example usage
api_key = "your_api_key"
invoice = create_invoice(api_key, 10000, "Product purchase")
print(f"Payment request: {invoice['invoice']['invoice']}")
print(f"Checking ID: {invoice['invoice']['id']}")

Powerful Features for Developers

Our API is designed to make Bitcoin and Lightning Network payments simple to integrate.

Lightning Network

Fast, low-fee Bitcoin payments

Create BOLT11 invoices
Support for multiple fiat currencies
Check payment status
Generate QR codes

On-chain Bitcoin

Traditional Bitcoin transactions

Generate Bitcoin addresses
Track transaction confirmations
Automatic payment verification

Webhooks

Real-time payment notifications

Instant payment notifications
Secure signature verification
Automatic retries for failed deliveries

Simple API Endpoints

Our API is designed to be intuitive and easy to use, with clear endpoints for all your payment needs.

Lightning Network Endpoints

Create and manage Lightning Network invoices for instant Bitcoin payments.

POST

/lightning/invoice/

Create a new lightning invoice

QR code available

GET

/lightning/invoice/qr/{id}

Get QR code for a lightning invoice by checking ID

Returns PNG image

GET

/lightning/invoice/status/{id}

Get the status of an Lightning invoice by checking ID

Webhook notifications available

# Lightning Invoice Endpoints

POST /api/lightning/invoice/
  Create a new lightning invoice
  
  Request:
  {
    "amount": 10000,
    "memo": "Product purchase",
    "currency": "sat",
    "extra": {}
  }
  
  Response:
  {
    "message": "Invoice created successfully",
    "invoice": {
      "payment_hash": "...",
      "id": "...",
      "invoice": "lnbc...",
      "amount": "...",
      "currency": "..."
    }
  }

GET /api/lightning/invoice/qr/{id}
  Get QR code for a lightning invoice by checking ID

GET /api/lightning/invoice/status/{id}
  Get the status of an Lightning invoice by checking ID

One Script Tag Integration

Add Bitcoin payments to any website with a single script tag. No complex setup required.

<!-- Aurora Unified Payment Embed -->
<div id="aurora-payment"
     data-api-endpoint="https://aurora.mybuho.de/api/lightning/invoice/"
     data-api-key="your-api-key"
     data-amount="10.00"
     data-currency="EUR"
     data-description="Product purchase">
  Pay with Bitcoin
</div>

<script src="https://aurora.mybuho.de/embed.js"></script>

Add Script

Include Aurora script in your HTML

Add Element

Create payment div with data attributes

Accept Payments

Start receiving Bitcoin payments

Bitcoin PaymentsIn Just 5 Lines of Code