The companion app is not available on Google Play. Download the APK directly from the OwnPay GitHub releases page.
What the app does
- Receives incoming payment SMS - Listens for incoming SMS and applies a privacy filter that only passes through payment confirmation messages (mobile money receipts, bank transfer confirmations)
- Forwards to OwnPay - Sends only the filtered payment SMS content to your instance via the Mobile API. All non-payment SMS never leave the device
- Sends heartbeats - Periodic pings so OwnPay knows the device is online
- Receives push commands - Accepts remote instructions from the admin panel
The app has no access to outgoing, sent, or draft messages. It cannot read OTP codes, personal conversations, or any SMS other than incoming payment confirmations.
Install and pair
1
Download the latest
ownpay-companion-v0.2.0.apk from the GitHub releases page and install it on your Android device. You may need to enable Install from unknown sources in your device settings.2
Open the app and enter your OwnPay instance URL (for example,
https://pay.yourdomain.com) and the Mobile API key generated from Devices.3
Tap Pair Device. The app sends a registration request and displays a confirmation screen with the assigned device name.
4
Back in the OwnPay admin panel, go to Mobile > Devices and confirm the device appears with an Online status.
Permission requirements
The companion app requires the following Android permissions:Heartbeat mechanism
The app sends a heartbeat to your OwnPay instance every 60 seconds. If OwnPay does not receive a heartbeat within 10 minutes, the device status changes to Offline in the admin panel. See Devices for health monitoring details.Troubleshooting pairing
Related Pages
- Devices - Manage paired devices and monitor health
- SMS Templates - Configure regex patterns for SMS verification
- SMS Center - View incoming payment SMS logs and outbound notification queue