zenjahid/bkash-sync

bKash is a mobile money service widely used in Bangladesh for sending payments between people. bKash Sync is an Android app that watches for bKash payment confirmation text messages (SMS), reads the transaction details out of them, stores them locally, and uploads them to a custom backend server. The goal is to let website or app developers verify incoming bKash payments automatically, without needing access to the official bKash merchant API. The intended workflow is: a customer sends money to your personal bKash number and receives a confirmation SMS with a transaction ID. The app running on your Android phone detects that SMS in the background, parses out the amount, sender phone number, and transaction ID, and syncs those details to a Cloudflare serverless backend you control. When the customer enters their transaction ID on your website, your site queries that backend to confirm the payment matched. The app is built with an offline-first design. Transactions are saved to a local SQLite database on the phone first, then queued for upload when a network connection is available. A background worker handles retries if the upload fails. The server side is a Cloudflare Worker (a small JavaScript function hosted on Cloudflare's global network) backed by a Cloudflare D1 database, which is a hosted SQLite service. The project ships two main parts: the Android app written in Kotlin, and the Cloudflare Worker backend written in TypeScript. Setup involves deploying the Worker to your Cloudflare account, initializing the database schema, and building the Android APK in Android Studio. The README notes that Google Play Protect will flag the APK as unrecognized because it is distributed outside the Play Store, and includes steps for working around that warning. The repository also includes screenshots of the app's dashboard, settings, and transaction list screens.