PESAQR
A lightweight, framework-agnostic library for generating M-PESA Payment QR codes. Built using Web Components, PesaQR works seamlessly with any modern JavaScript framework or vanilla HTML.
## Features
- 🎯 Generate Payment QR codes for Till Numbers
- 💳 Generate Payment QR codes for Paybill Numbers
- 📱 Generate Payment QR codes for Phone Numbers (Send Money)
- 🔌 Framework agnostic - works with React, Vue, Angular, or vanilla JavaScript
- 📱 Mobile-responsive
- 🔒 Offline support
## Installation
```bash
npm install pesaqr
```
## Usage
### Basic HTML
```html
```
### React
```jsx
import "pesaqr";
function App() {
return ;
}
```
### Vue
```html
```
### Angular
```typescript
// app.module.ts
import { NgModule, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import 'pesaqr';
@NgModule({
// ...
schemas: [CUSTOM_ELEMENTS_SCHEMA]
})
export class AppModule { }
// component template
```
## API Reference
### Properties
| Property | Type | Description | Required |
| ------------- | ------- | ------------------------------------------- | ------------------------ |
| type | string | Payment type: "till", "paybill", or "phone" | Yes |
| tillNumber | string | Till number for till payments | Yes (for type="till") |
| paybillNumber | string | Paybill number for paybill payments | Yes (for type="paybill") |
| accountNumber | string | Account number for paybill payments | Yes (for type="paybill") |
| phoneNumber | string | Phone number for send money payments | Yes (for type="phone") |
| amount | string | Payment amount | Yes |
| width | number | QR code width in pixels | No (default: 600) |
## Browser Support
- Chrome/Edge (latest)
- Firefox (latest)
- Safari (latest)
- Opera (latest)
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
[MIT](https://choosealicense.com/licenses/mit/)
## Author
David Amunga
[](https://davidamunga.com)
[](https://www.linkedin.com/in/david-amunga)
[](https://twitter.com/davidamunga_)
## Feedback
If you have any feedback or questions, please reach out to me on [Twitter](https://twitter.com/davidamunga_).