NB: a core rewrite of the project is being carried out, the goal is to make the crate easier to maintain,
improve the performance, abstract certain features to improve flexibility, and support for both blocking and non-blocking operations.
Convenient Rust bindings and types for the Paystack HTTP API aiming to support the entire API surface. Not the case? Please open an issue. I update the definitions on a weekly basis.
The client aims to make receiving payments for African business or business with African clients building with Rust as hassle-free as possible.
Note : While the crate aims to support sync and async use cases, only async use case is supported at the moment.
The client currently covers the following section of the API, and the sections to be implemented in order are left unchecked:
- Transaction
- Transaction Split
- Terminal
- Customers
- Dedicated Virtual Account
- Apple Pay
- Subaccounts
- Plans
- Subscriptions
- Transfer Recipients
- Transfers
- Transfers Control
- Bulk Charges
- Integration
- Charge
- Disputes
- Refunds
- Verifications
- Miscellaneous
See the Rust API docs or the examples.
paystack-rs uses the reqwest HTTP client under the hood and the tokio runtime for async operations.
[dependencies]
paystack-rs = "0.x.x"You can also download the source code and use in your code base directly if you prefer.
Initializing an instance of the Paystack client and creating a transaction.
use std::env;
use dotenv::dotenv;
use paystack::{PaystackClient, InitializeTransactionBodyBuilder, PaystackAPIError, Currency, Channel, ReqwestClient};
#[tokio::main]
async fn main() -> Result<(), PaystackAPIError> {
dotenv().ok();
let api_key = env::var("PAYSTACK_API_KEY").unwrap();
let client = PaystackClient<ReqwestClient>::new(api_key);
let email = "[email protected]".to_string();
let amount ="10_000".to_string();
let body = TransactionRequestBuilder::default()
.amount(amount)
.email(email)
.currency(Currency::NGN)
.channel(vec![
Channel::Card,
Channel::ApplePay,
Channel::BankTransfer,
Channel::Bank,
])
.build()?;
let res = client.transaction.initialize_transaction(body).await?;
// Assert
println!("{}", res.status);
println!("{}", res.message);
Ok(())
}We provide some examples of use cases for the Paystack-rs crate. The examples are located in the examples folder.
See CONTRIBUTING.md for information on contributing to paystack-rs.
We use Github actions to conduct CI/CD for the crate. It ensure that code is formated properly using cargo fmt, as well
as proper linting using cargo clippy, and finally run all the integration and unit test using cargo test.
A conceptual overview of the crate is illustrated below. This is to help improve the understanding of how the different
parts of the crate interact with each other to work efficiently. The PaystackClient module is the central module of
the crate and the best entry point to explore the different parts of the crate.
Licensed under MIT license (LICENSE-MIT).