BDApps Integration Guide

curl https://api.appspro.dev/api/v1/sdk/verify/tel:8801712345678 \
  -u "your_client_id:your_client_secret"

Authorization: Basic base64(client_id:client_secret)

{
  "valid": true,
  "subscriber": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "bdapps_subscriber_id": "tel:8801712345678",
    "phone_masked": "01712***678",
    "status": "active",
    "subscription_type": "bdapps",
    "frequency": "daily",
    "subscribed_at": "2026-05-11T10:30:00Z",
    "cancelled_at": null,
    "created_at": "2026-05-11T10:30:00Z"
  },
  "reason": null
}

{
  "subscribers": [
    {
      "id": "...",
      "bdapps_subscriber_id": "tel:8801712345678",
      "phone_masked": "01712***678",
      "status": "active",
      "frequency": "daily",
      "subscribed_at": "2026-05-11T10:30:00Z"
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20
}

// POST body
{ "phone": "01712345678" }

// Response
{
  "reference_no": "bdapps_ref_abc123",
  "status_code": "S1000",
  "status_detail": "Success"
}

// POST body
{
  "reference_no": "bdapps_ref_abc123",
  "otp": "1234"
}

// Response
{
  "subscription_status": "REGISTERED",
  "subscriber_id": "tel:8801712345678",
  "local_subscriber_id": "550e8400-...",
  "redirect_url": "https://yourapp.com/welcome",
  "status_code": "S1000",
  "status_detail": "Success"
}

POST https://your-server.com/webhooks/texionapps

Headers:
  Content-Type: application/json
  X-Event-Type: subscriber.created
  X-Signature: sha256=abc123...

Body:
{
  "event": "subscriber.created",
  "data": {
    "timeStamp": "2026-05-11T10:30:00Z",
    "applicationId": "BDAPPS_123",
    "subscriberId": "tel:8801712345678",
    "status": "REGISTERED",
    "frequency": "daily",
    "internal_subscriber_id": "550e8400-..."
  }
}

{
  "event": "sms.received",
  "data": {
    "applicationId": "BDAPPS_123",
    "sourceAddress": "tel:8801712345678",
    "message": "Hello from subscriber",
    "requestId": "req_xyz",
    "encoding": "0"
  }
}

import hmac, hashlib

def verify_signature(body: bytes, signature: str, signing_key: str) -> bool:
    expected = hmac.new(
        signing_key.encode(),
        body,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

// POST body
{
  "destination": ["01712345678", "01898765432"],
  "message": "Hello from your app!",
  "source_address": null
}

// Response
{
  "sent_count": 2,
  "status_code": "S1000",
  "status_detail": "Success"
}

// POST body
{ "message": "Daily update for all subscribers" }

// Response
{ "sent_count": 150, "status_code": "S1000", "status_detail": "Success" }

// POST body
{
  "phone": "01712345678",
  "amount": "10.00",
  "external_trx_id": "txn_abc123"
}

// Response
{ "status_code": "S1000", "status_detail": "Success" }

<script src="https://appspro.dev/sdk/v1/texionapps.js"></script>

<!-- In your HTML -->
<div id="subscribe-box"></div>

<script>
  const sdk = AppsPro('YOUR_PUBLIC_KEY');

  const el = sdk.elements.create('subscribe', {
    buttonText:  'Subscribe Now',
    buttonColor: '#6366f1',   // any CSS hex color
    theme:       'dark',      // 'dark' | 'light'
    locale:      'en',
    compact:     false,       // smaller padding
    hideHeader:  false,       // hide app name header
  });

  el.mount('#subscribe-box');

  el.on('ready',   ()     => console.log('Widget ready'));
  el.on('success', (data) => {
    console.log('Subscribed!', data.subscriberId);
    // Verify on your server:
    // GET /api/v1/sdk/verify/{data.subscriberId}
  });
  el.on('error',   (err)  => console.error('Error:', err.message));
</script>

sdk.elements.create('subscribe', {
  buttonText:   string,   // default: 'Subscribe Now'
  buttonColor:  string,   // default: '#6366f1'
  theme:        string,   // 'dark' | 'light', default: 'dark'
  locale:       string,   // default: 'en'
  compact:      boolean,  // default: false
  hideHeader:   boolean,  // default: false
  borderRadius: string,   // default: '12px'
  baseUrl:      string,   // override API base (dev only)
})

import 'dart:convert';
import 'package:webview_flutter/webview_flutter.dart';

class SubscribeWebView extends StatefulWidget {
  final String publicKey;
  const SubscribeWebView({required this.publicKey, super.key});

  @override
  State<SubscribeWebView> createState() => _SubscribeWebViewState();
}

class _SubscribeWebViewState extends State<SubscribeWebView> {
  late final WebViewController _controller;

  @override
  void initState() {
    super.initState();
    _controller = WebViewController()
      ..setJavaScriptMode(JavaScriptMode.unrestricted)
      ..addJavaScriptChannel(
        'AppsPro',  // SDK calls window.AppsPro.postMessage() automatically
        onMessageReceived: (msg) {
          final data = jsonDecode(msg.message) as Map<String, dynamic>;
          if (data['type'] == 'success') {
            final subscriberId = data['data']['subscriberId'];
            Navigator.pop(context, subscriberId);
          }
        },
      )
      ..loadHtmlString(_buildHtml());
  }

  String _buildHtml() => """
<!DOCTYPE html><html><head>
<meta name="viewport" content="width=device-width,initial-scale=1">
<script src="https://appspro.dev/sdk/v1/texionapps.js"></script>
</head><body style="margin:0;background:#0f0f13">
<div id="sub"></div>
<script>
  const sdk = AppsPro('${widget.publicKey}');
  const el = sdk.elements.create('subscribe', { hideHeader: true });
  el.mount('#sub');
  // Events fire automatically to the AppsPro JavascriptChannel
</script></body></html>""";

  @override
  Widget build(BuildContext context) => WebViewWidget(controller: _controller);
}