# Laravel M-Pesa STK Push Integration Guide
A comprehensive, modern, and reusable guide for integrating M-Pesa STK Push payments into Laravel applications. This guide is open, neutral, and up-to-date with best practices. All code samples are generic, and security/logging recommendations are for debugging and troubleshooting only.
---
---
## Table of Contents
1. Introduction
2. Prerequisites
3. Project Setup
4. M-Pesa API Overview
5. STK Push Integration
6. Callback Handling & Security
7. Status Updates & Polling
8. Payment Tracking & Reporting
9. Troubleshooting
10. Code Samples
11. FAQ
12. Using the Official Laravel Package
---
## Usage
- Start with the Introduction and follow each section in order for a smooth integration experience.
- Use the code samples as templates for your own Laravel projects.
- For a ready-to-use Composer package, see below.
---
## Using the Official Laravel Package
For most projects, you can save time and follow best practices by using the official open-source package:
**Package:** `me12free/laravel-mpesa-stkpush-sandbox`
```bash
composer require me12free/laravel-mpesa-stkpush-sandbox
```
See the package documentation for installation, configuration, and usage details.
---
## 🧪 Looking for a Sandbox-Only Package?
If you want a lightweight, open-source Laravel package focused solely on M-Pesa STK Push sandbox integration, check out:
- me12free/laravel-mpesa-stkpush-sandbox
This package is ideal for quick prototyping, testing, and learning before moving to production.
---
## ⭐ Rate & React
If you found this guide helpful:
- Star this repository on GitHub
- Join the discussion and leave your feedback!
- React with 👍 or ❤️ to let others know it’s useful!
Your feedback helps improve this resource for everyone.
---
## License
This guide is for educational and integration purposes only. You are responsible for your own implementation and compliance.