Merge pull request #216 from Domains18/feature/complete-daraja-integration

Add complete Daraja API integration with 8 new service modules

Author: Domains18

.env.example

@@ -0,0 +1,65 @@
+# Server Configuration
+PORT=3000
+
+# Database Configuration
+DATABASE_URL="mysql://user:password@localhost:3306/mpesa_db"
+
+# M-Pesa Environment (SANDBOX or PRODUCTION)
+MPESA_ENV=SANDBOX
+
+# Safaricom Daraja API Credentials
+CONSUMER_KEY=YOUR_CONSUMER_KEY
+CONSUMER_SECRET=YOUR_CONSUMER_SECRET
+
+# STK Push Configuration
+PASS_KEY=YOUR_PASSKEY
+STK_SHORTCODE=174379
+STK_CALLBACK_URL=https://yourdomain.com/api/mpesa/callback
+
+# Initiator Credentials (for B2C, B2B, Balance, Status, Reversal)
+INITIATOR_NAME=YOUR_INITIATOR_NAME
+INITIATOR_PASSWORD=YOUR_INITIATOR_PASSWORD
+
+# M-Pesa Certificate Path
+MPESA_CERT_PATH=./certificates/ProductionCertificate.cer
+
+# C2B Configuration
+C2B_SHORTCODE=600496
+C2B_VALIDATION_URL=https://yourdomain.com/api/c2b/validation
+C2B_CONFIRMATION_URL=https://yourdomain.com/api/c2b/confirmation
+
+# B2C Configuration
+B2C_SHORTCODE=YOUR_B2C_SHORTCODE
+B2C_RESULT_URL=https://yourdomain.com/api/b2c/callback/result
+B2C_TIMEOUT_URL=https://yourdomain.com/api/b2c/callback/timeout
+
+# B2B Configuration
+B2B_SHORTCODE=YOUR_B2B_SHORTCODE
+B2B_RESULT_URL=https://yourdomain.com/api/b2b/callback/result
+B2B_TIMEOUT_URL=https://yourdomain.com/api/b2b/callback/timeout
+
+# Account Balance Configuration
+BALANCE_SHORTCODE=YOUR_SHORTCODE
+BALANCE_RESULT_URL=https://yourdomain.com/api/account-balance/callback
+BALANCE_TIMEOUT_URL=https://yourdomain.com/api/account-balance/timeout
+
+# Transaction Status Configuration
+STATUS_SHORTCODE=YOUR_SHORTCODE
+STATUS_RESULT_URL=https://yourdomain.com/api/transaction-status/callback
+STATUS_TIMEOUT_URL=https://yourdomain.com/api/transaction-status/timeout
+
+# Reversal Configuration
+REVERSAL_RESULT_URL=https://yourdomain.com/api/reversal/callback
+REVERSAL_TIMEOUT_URL=https://yourdomain.com/api/reversal/timeout
+
+# Dynamic QR Configuration
+QR_MERCHANT_NAME=YOUR_MERCHANT_NAME
+
+# Bill Manager Configuration
+BILL_SHORTCODE=YOUR_BILL_SHORTCODE
+BILL_EMAIL=your-email@example.com
+BILL_OFFICIAL_CONTACT=YOUR_CONTACT
+BILL_CALLBACK_URL=https://yourdomain.com/api/bill-manager/callback
+
+# Redis Configuration
+REDIS_URL=redis://localhost:6379

.gitignore

@@ -42,6 +42,11 @@ lerna-debug.log*
 .env.production.local
 .env.local
 
+# M-Pesa Certificates
+certificates/*.cer
+certificates/*.crt
+certificates/*.pem
+
 # temp directory
 .temp
 .tmp