Crate daraja_sdk 

Daraja SDK

A memory-safe Rust SDK for Safaricom Daraja (M-Pesa API 3.0), focused on correctness and type safety.

Experimental: This crate is an early experiment. The API is unstable, coverage is limited, and it is not ready for production use.

Environments

API builders default to the Daraja sandbox. Call .production() on each builder that will send a request when you are ready to use live credentials and passkeys.

Environment is configured per endpoint builder — there is no shared global setting. If you obtain an access token and then call another API, call .production() on both builders so the token and the downstream request target the same environment.

OAuth

use daraja_sdk::{DarajaApi, mpesa};

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
    let client = mpesa::Client::with_credentials("your-consumer-key", "your-consumer-secret");
    let token = client.generate_access_token().await?;
    println!("{}", token.access_token);

    Ok(())
}

Production:

use daraja_sdk::{DarajaApi, mpesa};

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
    let client = mpesa::Client::with_credentials("your-consumer-key", "your-consumer-secret")
        .production();
    let token = client.generate_access_token().await?;
    println!("{}", token.access_token);

    Ok(())
}

M-Pesa Express (STK Push)

Obtain an access token first (see OAuth above), then:

use daraja_sdk::mpesa::{ExpressError, MpesaExpress};

#[tokio::main]
async fn main() -> Result<(), ExpressError> {
    let response = MpesaExpress::new()
        .access_token("your-access-token")
        .passkey("your-lipa-na-mpesa-passkey")
        .business_short_code(174379)
        .party_a(254700000000)
        .party_b(174379)
        .phone_number(254700000000)
        .amount(1)
        .account_reference("Order123")
        .tx_description("Payment")
        .call_back_url("https://your-domain.com/callback")
        .send_prompt()
        .await?;

    println!("{}", response.customer_message);
    Ok(())
}

Production:

use daraja_sdk::{DarajaApi, mpesa::{ExpressError, MpesaExpress}};

#[tokio::main]
async fn main() -> Result<(), ExpressError> {
    let response = MpesaExpress::new()
        .production()
        .access_token("your-production-access-token")
        .passkey("your-production-passkey")
        .business_short_code(174379)
        .party_a(254700000000)
        .party_b(174379)
        .phone_number(254700000000)
        .amount(1)
        .account_reference("Order123")
        .tx_description("Payment")
        .call_back_url("https://your-domain.com/callback")
        .send_prompt()
        .await?;

    println!("{}", response.customer_message);
    Ok(())
}

Transaction results are posted to your callback URL. Handle those in your application; this crate only initiates the STK Push prompt.

Re-exports

pub use types::DarajaApi;

pub use types::DarajaEnvironment;

Modules

mpesa

M-Pesa client for the Safaricom Daraja API.

types

Shared types for building Daraja API requests.