gowelle/laravel-beem-africa

A comprehensive Laravel package for integrating with Beem's APIs. This package provides a unified interface for SMS, Airtime, OTP, Payment Checkout, Disbursements, Collections, USSD, Contacts, Moja (multi-channel messaging), and International SMS services. # Beem Laravel Package A comprehensive Laravel package for integrating with Beem's APIs. This package provides a unified interface for **SMS**, **Airtime**, **OTP**, **Payment Checkout**, **Collections**, **Contacts**, **Moja** (multi-channel messaging), and **International SMS** services. ## Table of Contents - Features - Requirements - Installation - Configuration - Usage - Payment Checkout - OTP (One-Time Password) - Airtime Top-Up - SMS - Collections - Contacts - Moja (Multi-Channel Messaging) - Multicountry SMS and SMPP - UI Components - Livewire Components - Vue/InertiaJS Components - Testing - Security - Credits - License ## Features ### Payment Checkout - 🔄 **Redirect Checkout** - Redirect users to Beem's hosted checkout page - 🖼️ **Iframe Checkout** - Embed checkout within your application - 🔔 **Webhook Handling** - Automatic webhook processing with Laravel events - 🛡️ **Secure Token Support** - Optional callback correlation token support - 💾 **Transaction Storage** - Optional database storage for payment records ### OTP (One-Time Password) - 📱 **Send OTP** - Send verification codes via SMS - ✅ **Verify OTP** - Validate user-entered codes - 🔐 **Phone Verification** - Secure phone number verification flow - 🎯 **Error Codes** - 18 detailed error codes for precise handling ### Airtime Top-Up - 💰 **Transfer Airtime** - Send mobile credit across 40+ African networks - 📊 **Check Balance** - Monitor your airtime credit balance - 🔍 **Transaction Status** - Track airtime transfer status - 🔔 **Callback Support** - Receive real-time transfer notifications - 🎯 **Response Codes** - 16 detailed error codes for precise handling ### SMS - 📨 **Send SMS** - Send single or bulk SMS to 22+ regions - 📋 **Sender Names** - Manage custom sender IDs - 📄 **Templates** - Use pre-configured message templates - 📊 **Balance Check** - Monitor SMS credit balance - 📬 **Delivery Reports** - Track message delivery status - 📲 **Two Way SMS** - Receive inbound SMS messages - ⏰ …