Expand description
§razorpay-rs
An async, type-safe, idiomatic Rust SDK for the Razorpay API.
§Overview
razorpay-rs provides access to Razorpay’s payments platform including:
- Orders & Payments: Create orders, capture payments, handle OTPs, and issue refunds.
- Payment Links & Invoices: Generate hosted payment links and invoice line items.
- Subscriptions & Plans: Set up recurring billing cycles, addons, and e-mandates.
- Smart Collect & Virtual Accounts: Create virtual bank accounts and UPI VPAs.
- Route & Transfers: Split payments and manage linked marketplace accounts.
- Disputes & Settlements: Track chargebacks and on-demand instant settlements.
- Bills: Manage retail and point-of-sale (POS) digital receipts.
- Webhooks & Security: Constant-time signature verification for webhooks and checkouts.
§Creating a Client
§Basic Initialization
use razorpay::RazorpayClient;
let client = RazorpayClient::new("rzp_test_key", "test_secret")?;§Custom Configuration with Builder
use razorpay::RazorpayClientBuilder;
use std::time::Duration;
use url::Url;
let client = RazorpayClientBuilder::new()
.key_id("rzp_test_key")
.key_secret("test_secret")
.timeout(Duration::from_secs(30))
.build()?;§Usage Examples
§Creating an Order
use razorpay::{
Creatable, RazorpayClient,
models::CreateOrderRequest,
};
let client = RazorpayClient::new("rzp_test_key", "test_secret")?;
let req = CreateOrderRequest {
amount: 50000, // 500.00 INR in paise
currency: "INR".to_string(),
receipt: Some("rcpt_101".to_string()),
partial_payment: Some(false),
first_payment_min_amount: None,
transfers: None,
notes: None,
};
let order = client.orders().create(req, None).await?;
println!("Created order ID: {}", order.id);§Creating a Hosted Payment Link
use razorpay::{
Creatable, RazorpayClient,
models::CreatePaymentLinkRequest,
};
let client = RazorpayClient::new("rzp_test_key", "test_secret")?;
let req = CreatePaymentLinkRequest {
amount: 25000, // 250.00 INR in paise
currency: Some("INR".to_string()),
accept_partial: Some(false),
first_min_partial_amount: None,
expire_by: None,
reference_id: Some("tx_9981".to_string()),
description: Some("Product Purchase Link".to_string()),
customer: None,
notify: None,
reminder_enable: None,
notes: None,
callback_url: None,
callback_method: None,
};
let link = client.payment_links().create(req, None).await?;
println!("Payment Link URL: {}", link.short_url);§Verifying Checkout Payment Signature
use razorpay::webhooks::verify_payment_signature;
let order_id = "order_EKwxwAgItmmXdp";
let payment_id = "pay_29AeabbJyL3mAO";
let signature = "9ef4dffbfd84f1318f6739a3ce19f9d85851857ae648f114332d840193e13ff1";
let key_secret = "test_secret";
match verify_payment_signature(order_id, payment_id, signature, key_secret) {
Ok(()) => println!("Payment verified successfully!"),
Err(err) => eprintln!("Invalid signature: {:?}", err),
}§Verifying Webhook Signature
use razorpay::webhooks::verify_webhook_signature;
let raw_body = r#"{"entity":"event","event":"payment.captured"}"#;
let signature_header = "25134763133642c26279f041c2c31e4e138a4d46f5de019e0cc0ab961a8a25c1";
let webhook_secret = "my_webhook_secret";
match verify_webhook_signature(raw_body, signature_header, webhook_secret) {
Ok(()) => println!("Webhook verified successfully!"),
Err(err) => eprintln!("Webhook signature mismatch: {:?}", err),
}Re-exports§
pub use client::RazorpayClient;pub use client::RazorpayClientBuilder;pub use config::RazorpayConfig;pub use error::RazorpayError;pub use error::RazorpayResult;pub use resources::Accounts;pub use resources::Addons;pub use resources::Bills;pub use resources::Cards;pub use resources::CustomerTokens;pub use resources::Customers;pub use resources::Disputes;pub use resources::Documents;pub use resources::FundAccounts;pub use resources::Iins;pub use resources::Invoices;pub use resources::Items;pub use resources::Orders;pub use resources::PaymentLinks;pub use resources::Payments;pub use resources::Payouts;pub use resources::Plans;pub use resources::Products;pub use resources::QrCodes;pub use resources::Refunds;pub use resources::Settlements;pub use resources::Stakeholders;pub use resources::Subscriptions;pub use resources::Tokens;pub use resources::Transfers;pub use resources::VirtualAccounts;pub use resources::Webhooks;pub use traits::Creatable;pub use traits::Deletable;pub use traits::Fetchable;pub use traits::Listable;pub use traits::Updatable;