InApp SDK

Embed Telebirr payments directly inside your iOS or Android mobile app. The SDK handles the payment UI — your app passes a receiveCode and listens for the result.

Server-side: Use the PHP (melaku/telebirr) or JS/TS (@melakudemeke/telebirr-js) library’s createInAppOrder() to get the receiveCode. Client-side: Pass it to the iOS or Android SDK to launch the payment UI.

The short version:

// 1. Server: create the in-app order
$tokenInfo = $client->applyFabricToken();
$order = $client->createInAppOrder($tokenInfo['token'], 'Item name', '50.00');
$receiveCode = $order['biz_content']['receiveCode'];
 
// 2. Return receiveCode to your mobile app
echo json_encode(['receiveCode' => $receiveCode]);
 
// 3. Mobile app passes receiveCode to the SDK → payment UI launches

What InApp SDK is and when to use it vs the web checkout flow.

Introduction

Credentials you need and how to generate RSA keys.

Development Preparation

End-to-end flow — server and mobile app roles.

Service Process

Get a bearer token (library handles this automatically).

Step 1: Apply Fabric Token

createInAppOrder() → get receiveCode for the SDK.

Step 2: Create Order

Pass receiveCode to the SDK to launch the payment UI.

Step 3: CheckOut

Same as H5 C2B — verify signature, fulfill order.

Step 4: Notifications

EthiopiaPaySDK.framework setup for Xcode.

iOS Integration

EthiopiaPaySdkModule.aar setup for Android Studio.

Android Integration

Request Signature