1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
//! # Daraja SDK
//!
//! A memory-safe Rust SDK for [Safaricom Daraja](https://developer.safaricom.co.ke/) (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.
//!
//! Requests currently target the Daraja sandbox environment.
//!
//! ## OAuth
//!
//! ```no_run
//! use daraja_sdk::mpesa;
//!
//! #[tokio::main]
//! async fn main() -> Result<(), reqwest::Error> {
//! let client = mpesa::Client::with_credentials(
//! "your-consumer-key".into(),
//! "your-consumer-secret".into(),
//! );
//!
//! 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:
//!
//! ```no_run
//! 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(())
//! }
//! ```
//!
//! Transaction results are posted to your callback URL. Handle those in your application;
//! this crate only initiates the STK Push prompt.