Mini apps
A mini app is your own web app running inside the Yehulu wallet. Customers open it from Mini apps, are signed in automatically, and pay you with their wallet without leaving it.
telebirr compatible
Yehulu's mini-app API follows Ethio telecom telebirr's SuperApp mini-app API: the same endpoints, fields and signing. A mini app built for telebirr needs only a different base URL and keys.
From draft to live
Drafttesters only, sandbox
Sandboxdomain proven
In reviewa version submitted
Liveevery wallet user
- Register the appUnder Mini apps → New mini app: name, domain, category, description, logo, what the app needs, and your RSA public key. You get your sandbox credentials; the app secret is shown once.
- Test itAdd testers by phone number: the app appears in their wallet as a test app. Use the portal's Sandbox tab to run it with a test customer. Nothing real is charged in sandbox.
- Prove your domainPublish the file the portal gives you at
/.well-known/yehulu-miniapp-<app code>.txton your domain and click Verify. - Submit a versionGive the version number, the page to open, and the signed manifest. Automatic checks run on your domain, HTTPS and page; a passing version goes to Yehulu for review.
- Go liveWhen Yehulu approves the version, the app goes live for every wallet user. Issue your production credentials on the Overview tab and have your developer switch your server to them straight away: from approval on, customers (testers included) are signed in to production, and payments are real.
Taking a live app back to draft
- Move to draft takes a live app out of the wallet for customers straight away, for maintenance or a big change. Your testers keep it.
- Publish puts it back live without a new review, as long as it has an approved version.
- Only Yehulu can turn an app off completely. If that happens, contact Yehulu support.
What an app can ask for
| Capability | What it allows |
|---|---|
payment.initiate | Take payments with the wallet's payment sheet |
profile.read | Receive the customer's name and phone number. Needs Yehulu's approval and the customer's consent |
order.read | Read order status |
location.read | Read the customer's location, with their consent |
Managing your apps
| Tab | Use it to |
|---|---|
| Overview | See the app's IDs and keys, its status, and move it between draft and live |
| Sandbox | Run the app with a test customer: PIN 123456 approves a payment, 000000 declines it |
| Keys | Upload or generate your RSA key pair, and copy Yehulu's public key |
| Domain & versions | Prove your domain and submit versions for review |
| Testers | Add the phone numbers that can open the app before it's live |
| Notifications | See every payment notification sent to your server and resend failed ones |
| Settings | Edit details and the logo, or delete the app |
Developers: continue with the integration guide.