1 unstable release
0.2.0 | Aug 12, 2023 |
---|
#185 in Finance
30KB
740 lines
This is an async rust library for accessing the mpesa apis.
To get an access token
use serde::{Serialize, Deserialize};
use base64::{Engine as _, engine::general_purpose};
#[derive(Debug. Serialize, Deserialize)]
struct Response {
access_token: String,
expires_in: i32,
}
#[tokio::main]
async fn main() {
let consumer_key = "Your consumer key here".to_string();
let consumer_secret = "Your consumer secret".to_string();
let client = reqwest::Client::new();
let auth = format!("{}:{}", consumer_key, consumer_secret);
let auth = general_purpose::URL_SAFE.encode(auth);
let body = client.get("mpesa token url here")
.header("Authorization", format!("Basic {}", auth))
.send()
.await
.unwrap();
let bytes = body
.bytes()
.await
.unwrap();
let response: Response = serde_json::from_slice(bytes.as_ref())
.unwrap();
println!({:?}, response);
}
Making a request
An Example of a Mpesa Express (STK Push) request:
let config = MpesaConfig::new().with_access_token();
/// Create a client to make requests with default config or you can provide your own check the docs for more info
let client = Client::with_config(config);
/// all fields must be provided as strings
let request = ExpressPushRequestArgs::default()
.PartyA("")
.PartyB("")
.Amount("")
.Password(shortcode, passkey, timestamp)
.AccountReference("")
.TransactionType("")
.BusinessShortCode("")
.CallbackURL("")
.TransactionDesc("")
.Timestamp("")
.PhoneNumber("")
.build()
.unwrap();
let response = client
///the appropriate method is required for the respective api you are trying to access.
.stkpush()
.create(request)
.await
.unwrap();
println!("{:?}", response);
Methods to make requests to the mpesa api
To access different request use the following methods to access the apis mpesa provides.
- Account Balance
AccountBalanceRequestArgs::Default()
- B2C
B2CRequestArgs::Default()
- Business Buy Goods
BusinessBuyGoodsRequestArgs::Default()
- Business PayBill
BusinessPayBillRequestArgs::Default()
- Mpesa Express Query
ExpressQueryRequestArgs::Default()
- QR code
QRRequestArgs::Default()
- Reverse Transaction
ReversalRequestArgs::Default()
- Mpesa Express (STK Push)
ExpressPushRequestArgs::Default()
- Transaction Status
TransactionStatusRequestArgs::Default()
- Tax Remit
TaxRemitRequestArgs::Default()
This library still works for those targeting the wasm
architecture.
Dependencies
~7–19MB
~283K SLoC