FutureScope Distributor Purchase API — v1

Production-ready foundation for distributor-led ordering, reseller attribution, customer activation, invoice creation, and license fulfillment.

Authentication

X-API-Key: fs_s_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Idempotency-Key: unique-order-request-id

Create Purchase

POST /api/v1/purchase
Content-Type: application/json

{
  "externalOrderId": "DIST-ORDER-1001",
  "partnerCode": "RES491230",
  "customerCompany": "ABC Bank",
  "customerEmail": "it@abcbank.com",
  "productName": "FutureScope AI",
  "productVersion": "v2.0",
  "osType": "Windows 11",
  "quantity": 10,
  "unitPrice": 49,
  "currency": "USD",
  "paymentTerms": "NET60"
}

Get Order Status

GET /api/v1/orders/{purchaseCode}

Operational Controls

• API keys are distributor-specific.
• Sandbox and production mode are separated by API client environment.
• Idempotency keys prevent duplicate purchase orders.
• Rate limiting is enforced per API client.
• Webhook events are queued for purchase.created and webhook.test.
• Audit events are written for production API actions.

OpenAPI

Download openapi.json

Lock 8 Fulfillment Additions

• RSA-signed license.dat generation using FUTURESCOPE_LICENSE_RSA_PRIVATE_KEY.
• Webhook delivery worker processes queued outbound events every 30 seconds.
• Customer product download endpoint validates entitlement before generating Bunny signed URL.

GET /api/customer/product-download/{assetId}?purchaseCode={purchaseCode}&email={customerEmail}