Language SDKs

Use a language SDK instead of raw HTTP. Each SDK handles OAuth refresh, retries, idempotency keys, pagination, and typed responses so your application code stays clean.

Python SDK

from mfi_sdk import MfiClient

client = MfiClient(
    base_url='https://microfinance.mybridgeerp.com',
    client_id='svc_kcb_disbursement',
    client_secret='...',
    scopes=['loans:read', 'disbursements:write'],
)

# List loans
for loan in client.loans.list(state='ready_to_disburse'):
    print(loan.id, loan.member_name, loan.principal)

# Create member with idempotency
member = client.members.create(
    name='Jane Wambui Mwangi',
    national_id='22748561',
    phone='+254712345678',
    branch_id=3,
    idempotency_key='jane-wambui-2026-03-15',
)

# Disburse
disb = client.loans.disburse(
    loan_id=9183,
    amount=5000000,
    channel='mpesa_b2c',
    msisdn='+254712345678',
    idempotency_key='disburse-9183-2026-03-15',
)

Node.js SDK

import { MfiClient } from '@bridgeerp/mfi-sdk';

const client = new MfiClient({
  baseUrl: 'https://microfinance.mybridgeerp.com',
  clientId: 'svc_kcb_disbursement',
  clientSecret: process.env.MFI_SECRET,
  scopes: ['loans:read', 'disbursements:write'],
});

// List loans (async iterator handles pagination)
for await (const loan of client.loans.list({ state: 'ready_to_disburse' })) {
  console.log(loan.id, loan.memberName, loan.principal);
}

// Create member
const member = await client.members.create({
  name: 'Jane Wambui Mwangi',
  nationalId: '22748561',
  phone: '+254712345678',
  branchId: 3,
}, { idempotencyKey: 'jane-wambui-2026-03-15' });

// Verify webhook signature
import { verifyWebhook } from '@bridgeerp/mfi-sdk';
const ok = verifyWebhook(rawBody, signature, secret);

Java SDK

// pom.xml
// <dependency>
//   <groupId>com.bridgeerp</groupId>
//   <artifactId>mfi-sdk</artifactId>
//   <version>1.4.0</version>
// </dependency>

MfiClient client = MfiClient.builder()
    .baseUrl("https://microfinance.mybridgeerp.com")
    .clientId("svc_kcb_disbursement")
    .clientSecret(System.getenv("MFI_SECRET"))
    .scopes(List.of("loans:read", "disbursements:write"))
    .build();

List<Loan> loans = client.loans()
    .list()
    .state("ready_to_disburse")
    .execute();

Member member = client.members().create(
    MemberCreate.builder()
        .name("Jane Wambui Mwangi")
        .nationalId("22748561")
        .phone("+254712345678")
        .branchId(3)
        .build(),
    RequestOptions.builder()
        .idempotencyKey("jane-wambui-2026-03-15")
        .build()
);

Go SDK

package main

import (
    "context"
    "log"
    "github.com/bridgeerp/mfi-sdk-go"
)

func main() {
    client := mfi.NewClient(mfi.Config{
        BaseURL:      "https://microfinance.mybridgeerp.com",
        ClientID:     "svc_kcb_disbursement",
        ClientSecret: os.Getenv("MFI_SECRET"),
        Scopes:       []string{"loans:read", "disbursements:write"},
    })

    ctx := context.Background()

    loans, err := client.Loans.List(ctx, &mfi.LoanListParams{State: mfi.String("ready_to_disburse")})
    if err != nil { log.Fatal(err) }

    for _, l := range loans.Data {
        log.Printf("%d %s %d", l.ID, l.MemberName, l.Principal)
    }

    member, err := client.Members.Create(ctx, &mfi.MemberCreateParams{
        Name:       "Jane Wambui Mwangi",
        NationalID: "22748561",
        Phone:      "+254712345678",
        BranchID:   3,
    }, mfi.RequestOptions{IdempotencyKey: "jane-wambui-2026-03-15"})
}

Common SDK features

• Automatic OAuth token caching and refresh
• Exponential backoff on 429 and 5xx
• Idempotency-Key support on all mutating methods
• Webhook signature verification helper
• Pluggable HTTP client for proxy / TLS customisation
• Pluggable logger for structured request/response logging
• Typed response models — full IDE auto-complete
• Async iterators / streams for pagination

Worked scenarios

Reference

SDK version compatibility

Common config options

Troubleshooting

See also

• Api
• Rest
• Openapi
• Webhooks