Skip to main content

Crate razorpay

Crate razorpay 

Source
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);
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::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;

Modules§

client
config
error
models
resources
traits
webhooks