Setup & Environment Configuration

To protect credentials and prevent system unauthorized exposure, the Receipt Manager platform utilizes strict external environment variables. The system implements a robust fallback structure to maintain compatibility across varying deployment lifecycle pipelines (e.g., Local Development, Staging, and production Vercel cloud architecture).

Environment Configuration Checklist

Add the following environment entries into your .env.local or target infrastructure management panel.

1. Gateway Routing Configuration

• BONGATECH_API_URL: Specifies the primary REST gateway endpoint.
  • Default value: https://bulk.bongatech.co.ke/api/v1/send-sms

2. Authentication Credentials

1. BONGATECH_API_KEY (Standard Production Identifier)

3. Header Identification Keys

1. BONGATECH_SENDER_ID (Standard Alphanumeric Aligned Header)

---

Sample Local Configuration File (.env.local)

iniCopy
# ==============================================================================
# BONGA TECH SMS SUB-SYSTEM ENV CONFIGURATION
# ==============================================================================

# Gateway Endpoint URL
BONGATECH_API_URL=[https://bulk.bongatech.co.ke/api/v1/send-sms](https://bulk.bongatech.co.ke/api/v1/send-sms)

# Authentication Keys (Never hardcode or commit keys directly to source control)
BONGATECH_API_KEY=bt_sk_live_9a7d32e5b1f4c6e80d2a1b3c4d5e6f

# Registered Alphanumeric Sender Profile ID (Max 11 Characters)
BONGATECH_SENDER_ID=GEOHACK

Configuration Guarding & Pre-flight Failures

To minimize wasteful network traffic and resource starvation, the module performs an intensive structure check immediately upon calling the delivery process.

If both credential matrices fail to find a valid key-pair setup, the system intercepts the execution stream instantly, blocks the HTTP payload construction, and drops a clear operational diagnostic payload back to the calling process:

iniCopy
{
  "success": false,
  "error": "BongaTech not configured: Missing API key/token (e.g., BONGATECH_API_KEY / BONGATECH_TOKEN) and Sender ID (e.g., BONGATECH_SENDER_ID). Please configure these environment variables in your Vercel project settings."
}