Sellauth → Keyauth Integration

Automated webhook integration for issuing product keys based on user purchases

Integration Architecture
How the webhook flow works
Step 1Sellauth PurchaseUser buys product
Step 2Webhook TriggeredPOST to your endpoint
Step 3Keyauth APIGenerate license key
Step 4Key DeliveredReturned to customer
API Endpoints
Webhook endpoint for Sellauth integration
POST/webhook/sellauth

Receives purchase data from Sellauth and generates Keyauth license keys

POST/webhook/sellauth/unlimited/datacenter

Generates unlimited datacenter proxy keys with tier-aware format: DCTRTx-****-****-****-****

T1 - 50MBPST2 - 100MBPST3 - 200MBPST4 - 500MBPST5 - 1000MBPS
POST/webhook/sellauth/unlimited/residentialComing Soon

Placeholder for unlimited residential proxy keys (RESITx-****-****-****-****)

Keyauth API Endpoint Used:

GEThttps://keyauth.win/api/seller/

Creates new license keys with configurable expiry, level, and quantity

Data Formats
Request and response structures

Sellauth Webhook Payload (Key Fields):

{
  "event": "INVOICE.ITEM.DELIVER-DYNAMIC",
  "email": "customer@shop.com",
  "item": {
    "quantity": 5,
    "product": { "name": "Product Name" },
    "variant": { "name": "Default" }
  },
  "customer": {
    "discord_id": "000000000000000000",
    "discord_username": "username"
  }
}

Successful Response (Plain Text):

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
YYYYY-YYYYY-YYYYY-YYYYY-YYYYY
(one key per line based on quantity)

Keyauth API Response:

{
  "success": true,
  "message": "Licenses successfully generated",
  "key": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"
}
Security Features
Built-in security measures

HMAC-SHA256 Signature

Verifies webhook authenticity using X-Signature header

Environment Variables

API keys stored securely, never exposed in code

Input Validation

Validates all incoming webhook data before processing

Error Handling

Comprehensive error responses for debugging

Setup Instructions
Configure your integration
  1. Set Environment Variables
    SELLAUTH_WEBHOOK_SECRET=your_webhook_secret_from_sellauth
    KEYAUTH_OWNER_ID=6FMXux0rip
    KEYAUTH_SELLER_KEY=your_seller_key
  2. Configure Sellauth Webhook

    Go to Storefront → Configure → Miscellaneous and set webhook URL to:

    https://api.proxigency.com/webhook/sellauth
  3. Set Product Level Mapping

    Configure product variants in Sellauth to map to Keyauth subscription levels