--- title: Razorpay API Integration on Truto slug: razorpay category: Payment Gateway canonical: "https://truto.one/integrations/detail/razorpay/" --- # Razorpay API Integration on Truto **Category:** Payment Gateway **Status:** Generally available ## Unified APIs ### Unified Payment Gateway API - **Customers** — The customer represents a customer in Payment Gateway. - **Payments** — The payment represents a payment in Payment Gateway. ## MCP-ready AI tools Truto exposes 100 tools for Razorpay that AI agents can call directly. - **list_all_razorpay_orders** — Get all orders in Razorpay. Returns id, amount, amount_paid, amount_due, currency, receipt, status, attempts, notes, and created_at for each order. - **get_single_razorpay_order_by_id** — Get details of a specific order in Razorpay by id. Returns id, amount, amount_paid, amount_due, currency, receipt, status, attempts, notes, and created_at fields. - **create_a_razorpay_order** — Create an order with amount and currency in Razorpay. Returns id, amount, amount_paid, amount_due, currency, receipt, status, attempts, notes, and created_at fields in the response. - **update_a_razorpay_order_by_id** — Update an order's notes field in Razorpay using id. Returns id, amount, entity, amount_paid, amount_due, currency, receipt, status, attempts, notes, and created_at fields in the response. - **list_all_razorpay_customers** — Get all customers in Razorpay. Returns id, name, contact, email, gstin, notes, and created_at timestamp for each customer. - **get_single_razorpay_customer_by_id** — Get details of a customer by id in Razorpay. Returns id, entity, name, contact, email, gstin, notes, and created_at timestamp. - **create_a_razorpay_customer** — Create a customer with name, contact, and email in Razorpay. Returns id, entity, name, contact, email, gstin, notes, and created_at timestamp. - **update_a_razorpay_customer_by_id** — Edit customer details such as name, email, and contact in Razorpay using id. Returns id, entity, name, contact, email, gstin, notes, and created_at fields. Ensure email and contact combination is unique. - **list_all_razorpay_payments** — Get all payments from Razorpay. Returns payment id, amount, currency, status, method, description, refund status, captured status, email, contact, and created_at timestamp. Supports from and to UNIX timestamps for filtering. - **get_single_razorpay_payment_by_id** — Get details of a specific payment in Razorpay using id. Returns fields including id, amount, currency, status, method, order_id, description, international, refund_status, amount_refunded, captured, email, contact, fee, tax, error_code, error_description, error_source, error_step, error_reason, notes, created_at, card_id, bank, vpa, wallet, and acquirer_data. - **update_a_razorpay_payment_by_id** — Update the notes field for a payment in Razorpay using id. Returns payment details including id, entity, amount, currency, status, method, order_id, description, international, refund_status, amount_refunded, captured, email, contact, fee, tax, error_code, error_description, error_source, error_step, error_reason, notes, created_at, card_id, card, upi, bank, vpa, wallet, and acquirer_data. - **razorpay_payments_card_details** — Get card details of a payment in Razorpay using id. Returns card id, entity, cardholder name, last4 digits, network, type, issuer, EMI eligibility, and sub_type. - **list_all_razorpay_order_payments** — Get all payments for an order in Razorpay using id. Returns payment id, amount, currency, status, method, order_id, description, international flag, refund_status, amount_refunded, captured flag, email, contact, fee, tax, error details, notes, created_at, card_id, wallet, acquirer_data, bank, and upi details. - **list_all_razorpay_settlements** — Get all settlements in Razorpay. Returns id, entity, amount, status, fees, tax, utr, and created_at for each settlement. - **get_single_razorpay_settlement_by_id** — Get details of a settlement by id in Razorpay. Returns id, entity type, amount, status, fees, tax, utr, and created_at timestamp. - **list_all_razorpay_settlement_recon** — Get a list of all transactions settled to your account for a specific year, month, and day in Razorpay. Returns entity_id, type, debit, credit, amount, currency, fee, tax, on_hold, settled, created_at, settled_at, settlement_id, description, notes, payment_id, settlement_utr, order_id, order_receipt, method, card_network, card_issuer, card_type, and dispute_id. - **list_all_razorpay_qr_codes** — Get multiple QR Codes in Razorpay filtered by from and to timestamps. Returns id, name, usage, type, image_url, payment_amount, status, description, fixed_amount, payments_amount_received, payments_count_received, notes, customer_id, close_by, closed_at, and close_reason fields. - **get_single_razorpay_qr_code_by_id** — Get details of a specific QR Code in Razorpay using id. Returns id, entity, created_at, name, usage, type, image_url, payment_amount, status, description, fixed_amount, payments_amount_received, payments_count_received, notes, customer_id, close_by, closed_at, and close_reason. - **create_a_razorpay_qr_code** — Create a QR Code in Razorpay with parameters type, name, usage, fixed_amount, payment_amount, description, customer_id, close_by, and notes. Returns id, entity, created_at, name, usage, type, image_url, payment_amount, status, description, fixed_amount, payments_amount_received, payments_count_received, notes, customer_id, close_by, closed_at, and close_reason. - **razorpay_qr_codes_close** — Close a QR Code by id in Razorpay. Returns fields including id, entity, created_at, name, usage, type, image_url, payment_amount, status, description, fixed_amount, payments_amount_received, payments_count_received, notes, customer_id, close_by, closed_at, and close_reason. - **list_all_razorpay_invoices** — Get all invoices in Razorpay. Returns invoice id, invoice_number, customer_id, status, amount, amount_paid, amount_due, currency, description, date, and short_url fields for each invoice. - **get_single_razorpay_invoice_by_id** — Get details of an invoice by id in Razorpay. Returns fields including id, entity, type, invoice_number, customer_id, customer_details, order_id, line_items, payment_id, status, timestamps, amount, currency, description, notes, short_url, and terms. - **update_a_razorpay_invoice_by_id** — Update an invoice by id in Razorpay. Allowed updates depend on invoice status. Returns updated invoice fields including id, invoice_number, customer_id, customer_details, line_items, status, expire_by, issued_at, paid_at, cancelled_at, expired_at, partial_payment, amount, amount_paid, amount_due, currency, description, notes, short_url, date, terms, and comment. - **delete_a_razorpay_invoice_by_id** — Delete an invoice by id in Razorpay. Only invoices in the draft state can be deleted. Returns an empty response on success. - **create_a_razorpay_invoice** — Create an invoice with customer_id in Razorpay. Returns invoice id, customer_details, line_items, status, amount, amount_paid, amount_due, currency, and short_url. Note: GST compliant fields cannot be added via API. - **razorpay_invoices_issue** — Issue an invoice with id in Razorpay. Only invoices in draft state can be issued. Returns invoice details including id, invoice_number, customer_id, line_items, status, amount, amount_paid, amount_due, currency, description, notes, short_url, and timestamps for issued_at and expire_by. - **list_all_razorpay_items** — Get all items in Razorpay. Returns id, active status, name, description, amount, unit_amount, currency, type, unit, tax_inclusive, hsn_code, sac_code, tax_rate, tax_id, tax_group_id, and created_at for each item. - **get_single_razorpay_item_by_id** — Get details of a specific item in Razorpay using id. Returns id, active status, name, description, amount, unit_amount, currency, type, unit, tax_inclusive, hsn_code, sac_code, tax_rate, tax_id, tax_group_id, and created_at timestamp. - **create_a_razorpay_item** — Create an item with name, amount, and currency in Razorpay. Returns id, active status, name, description, amount, unit_amount, currency, type, unit, tax_inclusive, hsn_code, sac_code, tax_rate, tax_id, tax_group_id, and created_at timestamp. - **update_a_razorpay_item_by_id** — Update an item by id in Razorpay. Returns id, active status, name, description, amount, unit_amount, currency, type, unit, tax_inclusive, hsn_code, sac_code, tax_rate, tax_id, tax_group_id, and created_at fields. - **delete_a_razorpay_item_by_id** — Delete an item by id in Razorpay. Returns an empty response on success. The id must be a valid existing item identifier. - **list_all_razorpay_plans** — Get all plans in Razorpay. Returns id, entity, interval, period, item details, notes, and created_at timestamp for each plan. - **get_single_razorpay_plan_by_id** — Get details of a plan by id in Razorpay. Returns id, entity, interval, period, item details, notes, and created_at timestamp. - **create_a_razorpay_plan** — Create a plan with period, interval, and item details including name, amount, and currency in Razorpay. Returns id, entity, interval, period, item details, notes, and created_at timestamp. - **list_all_razorpay_subscriptions** — Get all subscriptions in Razorpay. Returns subscription id, plan_id, customer_id, status, start_at, total_count, paid_count, remaining_count, and short_url for authorization payment. - **get_single_razorpay_subscription_by_id** — Get subscription details by id in Razorpay. Returns id, entity, plan_id, customer_id, status, current_start, current_end, ended_at, quantity, notes, charge_at, start_at, end_at, auth_attempts, total_count, paid_count, customer_notify, created_at, expire_by, short_url, has_scheduled_changes, schedule_change_at, offer_id, and remaining_count. - **create_a_razorpay_subscription** — Create a subscription in Razorpay with required parameters plan_id and total_count. Returns subscription id, plan_id, status, quantity, start_at, end_at, customer_notify, offer_id, notes, and remaining_count. - **update_a_razorpay_subscription_by_id** — Update a subscription by id in Razorpay. Returns fields including id, entity, plan_id, customer_id, status, current_start, current_end, ended_at, quantity, notes, charge_at, offer_id, start_at, end_at, auth_attempts, total_count, paid_count, customer_notify, created_at, expire_by, short_url, has_scheduled_changes, schedule_change_at, and remaining_count. - **get_single_razorpay_linked_account_by_id** — Get details of a Linked Account by id in Razorpay. Returns id, type, reference_id, status, email, phone, legal_business_name, business_type, profile, legal_info, notes, contact_name, contact_info, and apps fields. - **create_a_razorpay_linked_account** — Create a Linked Account in Razorpay with required parameters email, phone, legal_business_name, business_type, profile, and contact_name. Returns id, type, status, email, profile, phone, contact_name, reference_id, business_type, legal_business_name, customer_facing_business_name, and legal_info. - **update_a_razorpay_linked_account_by_id** — Update a Linked Account by id in Razorpay. Returns id, type, status, email, phone, legal_business_name, business_type, profile with legal_info, notes, contact_name, and contact_info fields. - **create_a_razorpay_stakeholder_account** — Create a stakeholder account for the given account_id in Razorpay. Returns stakeholder id, entity type, name, email, percentage_ownership, relationship (director, executive), phone numbers, addresses, kyc details, and notes. - **update_a_razorpay_stakeholder_account_by_id** — Update a stakeholder account in Razorpay using account_id and id. Returns id, entity, name, email, percentage_ownership, relationship, phone, addresses, kyc, and notes fields in the response. - **get_single_razorpay_product_configuration_by_id** — Get product configuration for account_id and id in Razorpay. Returns requested_configuration (pending config), active_configuration (current config with settlements details), requirements (fields needed), tnc (terms acceptance), id, product_name, activation_status, account_id, and requested_at. - **update_a_razorpay_product_configuration_by_id** — Update a product configuration for account_id and id in Razorpay. Returns requested_configuration (pending config), active_configuration (current config), requirements (needed to enable product), tnc (terms acceptance), id, product_name, activation_status, account_id, and requested_at. - **razorpay_product_configuration_request** — Request a product configuration for account_id in Razorpay. Returns id, product_name, tnc_accepted status, requested_configuration, active_configuration, requirements, activation_status, and requested_at timestamp. - **list_all_razorpay_customer_identifiers** — Get all Customer Identifiers in Razorpay. Returns id, name, entity, status, description, amount_expected, amount_paid, notes, customer_id, receivers, close_by, closed_at, and created_at fields. - **get_single_razorpay_customer_identifier_by_id** — Get Customer Identifier by id in Razorpay. Returns id, name, entity, status, description, amount_expected, amount_paid, customer_id, receivers, close_by, closed_at, and created_at fields. - **create_a_razorpay_customer_identifier** — Create a Customer Identifier with bank_account receiver type in Razorpay. Requires receivers with bank_account descriptor, description, customer_id, and close_by timestamp if temporary. Returns id, name, entity, status, description, amount_expected, amount_paid, notes, customer_id, receivers, close_by, closed_at, and created_at. - **create_a_razorpay_bill** — Create a bill in Razorpay. Requires store_code, business_type, business_category, customer details, receipt_timestamp, receipt_number, receipt_type, receipt_delivery, line_items, receipt_summary, taxes, and payments. Returns id, receipt_url, created_at, and detailed bill information. - **update_a_razorpay_bill_by_id** — Update a Bill by id in Razorpay. Returns updated bill details including id, business_type, business_category, customer info, store_code, receipt_timestamp, receipt_number, receipt_type, receipt_delivery, tags, line_items, receipt_summary, taxes, payments, event details, receipt_url, and created_at. - **delete_a_razorpay_bill_by_id** — Delete a bill by id in Razorpay. Returns the status field indicating deletion success. - **get_single_razorpay_account_by_id** — Get details of a specific account in Razorpay using id. Returns id, type, status, email, phone, legal_business_name, customer_facing_business_name, business_type, reference_id, and profile with business details. - **create_a_razorpay_account** — Create an account in Razorpay with required parameters email, phone, legal_business_name, business_type, profile.category, profile.subcategory, and contact_name. Returns id, type, status, email, phone, legal_business_name, customer_facing_business_name, business_type, profile, legal_info, brand, notes, contact_name, contact_info, apps, created_at, and other account details. - **update_a_razorpay_account_by_id** — Update details of a sub-merchant account in Razorpay using id. Returns fields including id, type, status, email, phone, legal_business_name, customer_facing_business_name, business_type, reference_id, profile, notes, created_at, and activation status. - **delete_a_razorpay_account_by_id** — Delete a sub-merchant account by id in Razorpay. Returns the suspended account's id, type, status, email, phone, legal_business_name, customer_facing_business_name, business_type, suspended_at timestamp, reference_id, profile details, legal_info, brand, notes, contact_name, contact_info, and apps. - **list_all_razorpay_stakeholders** — Get all stakeholders for an account in Razorpay using account_id. Returns id, name, email, percentage_ownership, relationship (director, executive), phone, addresses, kyc, and notes for each stakeholder. - **get_single_razorpay_stakeholder_by_id** — Get details of a stakeholder by account_id and id in Razorpay. Returns id, name, email, percentage_ownership, relationship (director, executive), phone, addresses, kyc, and notes. - **create_a_razorpay_stakeholder** — Create a stakeholder for account_id in Razorpay. Returns id, name, email, percentage_ownership, relationship (director, executive), phone, addresses, kyc, and notes fields in the response. - **update_a_razorpay_stakeholder_by_id** — Update a stakeholder's details by account_id and id in Razorpay. Returns id, percentage_ownership, name, email, relationship, phone, addresses, kyc, and notes fields in the response. - **list_all_razorpay_webhooks** — Get all webhooks for a given account_id in Razorpay. Returns id, created_at, updated_at, owner_id, owner_type, url, alert_email, secret_exists, entity, active, and events fields for each webhook. - **get_single_razorpay_webhook_by_id** — Get details of a webhook by account_id and id in Razorpay. Returns id, created_at, updated_at, owner_id, owner_type, url, alert_email, secret_exists, entity, active, and events fields. - **create_a_razorpay_webhook** — Create a webhook for account_id in Razorpay. Returns id, created_at, updated_at, owner_id, owner_type, url, alert_email, secret_exists, entity, active, and events fields in the response. - **update_a_razorpay_webhook_by_id** — Update a webhook with id for account_id in Razorpay. Returns id, created_at, updated_at, owner_id, owner_type, url, alert_email, secret_exists, entity, active, and events fields in the response. - **delete_a_razorpay_webhook_by_id** — Delete a webhook for a sub-merchant account in Razorpay using account_id and id. Returns an empty array on success. - **list_all_razorpay_payment_downtime_details** — Get all payment downtime details in Razorpay. Returns id, method, begin, end, status, scheduled, severity, instrument, created_at, and updated_at fields for each downtime. - **get_single_razorpay_payment_downtime_detail_by_id** — Get payment downtime details by id in Razorpay. Returns id, method, begin, end, status, scheduled, severity, instrument, created_at, and updated_at fields describing the downtime event. - **list_all_razorpay_instant_settlements** — Get all instant settlements in Razorpay. Returns id, amount_requested, amount_settled, amount_pending, amount_reversed, fees, tax, currency, settle_full_balance, status, description, notes, and created_at for each settlement. - **get_single_razorpay_instant_settlement_by_id** — Get details of a specific instant settlement in Razorpay using id. Returns id, entity type, amount_requested, amount_settled, amount_pending, amount_reversed, fees, tax, currency, settle_full_balance, status, description, notes, and created_at. - **create_a_razorpay_instant_settlement** — Create an Instant Settlement with amount, settle_full_balance, description, and notes in Razorpay. Returns id, entity, amount_requested, amount_settled, amount_pending, amount_reversed, fees, tax, currency, settle_full_balance, status, description, notes, created_at, and ondemand_payouts. - **list_all_razorpay_instant_settlements_payout_details** — Get all instant settlements with payout details in Razorpay. Returns id, amount_requested, amount_settled, amount_pending, fees, tax, currency, status, description, created_at, and ondemand_payouts with payout id, amount, fees, tax, utr, and status. - **get_single_razorpay_instant_settlements_payout_detail_by_id** — Get instant settlement with id in Razorpay including payout details. Returns id, entity, amount_requested, amount_settled, amount_pending, amount_reversed, fees, tax, currency, settle_full_balance, status, description, notes, created_at, and ondemand_payouts with payout id, amount, fees, tax, utr, status, and timestamps. - **list_all_razorpay_refunds** — Get all refunds in Razorpay. Returns refund id, amount, currency, payment_id, created_at timestamp, status, speed_requested, and speed_processed fields. - **get_single_razorpay_refund_by_id** — Get refund details by id in Razorpay. Returns id, entity, amount, currency, payment_id, created_at, batch_id, notes, receipt, acquirer_data, status, speed_requested, and speed_processed fields. - **create_a_razorpay_refund** — Create a normal refund for a payment in Razorpay using id. Returns refund id, amount, currency, payment_id, created_at timestamp, status, speed_requested, speed_processed, and notes. - **update_a_razorpay_refund_by_id** — Update the notes field of a refund in Razorpay using id. Returns id, entity, amount, currency, payment_id, created_at, batch_id, notes, receipt, acquirer_data, status, speed_requested, and speed_processed fields. - **list_all_razorpay_disputes** — Get all disputes in Razorpay. Returns id, payment_id, amount, currency, amount_deducted, reason_code, respond_by, status, phase, created_at, and evidence details for each dispute. - **get_single_razorpay_dispute_by_id** — Get details of a specific dispute in Razorpay by id. Returns id, entity, payment_id, amount, currency, amount_deducted, reason_code, respond_by, status, phase, created_at, and evidence details. - **create_a_razorpay_payment_link** — Create a UPI Payment Link with amount, currency, and upi_link set to true in Razorpay. Returns id, amount, currency, status, short_url, customer details, and payment link metadata. - **list_all_razorpay_payment_links** — Get all Standard Payment Links in Razorpay. Returns payment link details including id, amount, amount_paid, currency, status, short_url, description, created_at, updated_at, and customer information. Supports filtering by payment_id and reference_id. - **get_single_razorpay_payment_link_by_id** — Get details of a Standard Payment Link by id in Razorpay. Returns fields including amount, amount_paid, currency, status, customer details, payments array, short_url, and timestamps for creation and updates. - **update_a_razorpay_payment_link_by_id** — Update Standard Payment Link by id in Razorpay. Returns fields including accept_partial (partial payment allowed), amount (payment amount), amount_paid, currency, customer details, description, expire_by (expiry timestamp), id, notes, reference_id, short_url, status, updated_at, and reminder_enable. - **list_all_razorpay_contacts** — Get all contacts in Razorpay. Returns id, entity, name, contact, email, type, reference_id, batch_id, active status, notes, and created_at timestamp for each contact. - **get_single_razorpay_contact_by_id** — Get details of a specific contact by id in Razorpay. Returns id, entity, name, contact, email, type, reference_id, batch_id, active status, notes, and created_at timestamp. - **create_a_razorpay_contact** — Create a new contact in Razorpay with name, email, contact, type, and reference_id. Returns id, entity, name, contact, email, type, reference_id, batch_id, active status, notes, and created_at timestamp. - **update_a_razorpay_contact_by_id** — Update a contact by id in Razorpay. Returns id, entity, name, contact, email, type, reference_id, batch_id, active status, notes, and created_at timestamp. - **list_all_razorpay_fund_accounts** — Get all fund accounts in Razorpay. Returns id, entity, contact_id, account_type, active status, batch_id, and created_at timestamp for each fund account. - **get_single_razorpay_fund_account_by_id** — Get a fund account by id in Razorpay. Returns id, entity, contact_id, account_type, bank_account details (ifsc, bank_name, name, account_number, notes), active status, batch_id, and created_at timestamp. - **create_a_razorpay_fund_account** — Create a fund account with contact_id, account_type, and bank_account details in Razorpay. Returns id, entity, fund_account with active status, batch_id, status, results including created_at and utr. - **list_all_razorpay_payouts** — Get all payouts filtered by account_number in Razorpay. Returns payout id, fund_account_id, amount, currency, status, mode, reference_id, narration, created_at, and status_details describing payout status and details. - **get_single_razorpay_payout_by_id** — Get details of a specific payout by id in Razorpay. Returns id, entity, fund_account_id, amount, currency, fees, tax, status, mode, purpose, reference_id, narration, batch_id, status_details, created_at, and fee_type. - **create_a_razorpay_payout** — Create a payout to a bank account in Razorpay with account_number, fund_account_id, amount, currency, mode, and purpose. Returns payout id, fund_account_id, amount, currency, status, mode, purpose, reference_id, narration, notes, fees, tax, utr, batch_id, status_details, and created_at. - **create_a_razorpay_cards_payout** — Create a payout to a card fund account with account_number, amount, currency, mode, purpose, and fund_account details in Razorpay. Returns payout id, fund_account info, amount, currency, fees, tax, status, purpose, mode, reference_id, narration, and creation timestamp. - **create_a_razorpay_cards_fund_account** — Create a Fund Account of type card by saving the card as an external token in Razorpay. Requires contact_id, account_type as card, and card details including number, expiry_month, expiry_year, input_type, and token_provider. Returns id, contact_id, account_type, card details (last4, network, type, issuer, input_type), active status, batch_id, and created_at timestamp. - **list_all_razorpay_payout_links** — Get all Payout Links in Razorpay. Returns payout link id, contact details, purpose, status, amount, currency, description, short_url, created_at, contact_id, send_sms, send_email, fund_account_id, payout_id, cancelled_at, attempt_count, receipt, notes, expire_by, and expired_at. - **get_single_razorpay_payout_link_by_id** — Get payout link details by id in Razorpay. Returns id, entity, contact info, purpose, status, amount, currency, description, short_url, created_at, contact_id, send_sms, send_email, fund_account_id, payout_id, cancelled_at, attempt_count, receipt, notes, expire_by, and expired_at. - **create_a_razorpay_payout_link** — Create a Payout Link with account_number, contact details, amount, currency, purpose, description in Razorpay. Returns id, contact info, purpose, status, amount, currency, description, short_url, created_at, contact_id, send_sms, send_email, fund_account_id, payout_id, cancelled_at, attempt_count, receipt, notes, expire_by, expired_at. - **razorpay_payout_links_cancel** — Cancel a Payout Link by id in Razorpay. Returns fields including id, entity, contact details, purpose, status, amount, currency, description, short_url, created_at, contact_id, send_sms, send_email, fund_account_id, payout_id, cancelled_at, attempt_count, receipt, notes, expire_by, and expired_at. - **list_all_razorpay_transactions** — Get all transactions for account_number in Razorpay. Returns id, entity, account_number, amount, currency, credit, debit, balance, source details, and created_at timestamp. - **get_single_razorpay_transaction_by_id** — Get details of a specific transaction in Razorpay using id. Returns id, entity, account_number, amount, currency, credit, debit, balance, source details including fees, tax, status, utr, mode, and created_at timestamp. ## How it works 1. **Link your customer's Razorpay account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Razorpay.** The Proxy API is a 1-to-1 mapping of the Razorpay API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Embed payment collection into your SaaS workflow** — If you're building an invoicing, e-commerce, or booking platform, let your users connect their Razorpay account so orders, payments, and customers flow directly through your product — no redirect to a separate dashboard needed. - **Automate vendor and freelancer payouts** — SaaS platforms managing gig workers, vendors, or affiliates can programmatically create contacts, link fund accounts, and trigger payouts via RazorpayX — turning manual bank transfers into an automated disbursement engine inside your app. - **Power recurring billing and subscription management** — Membership platforms, PropTech tools, and course-creator SaaS can create plans, enroll customers into subscriptions, and track payment lifecycle events — all through their users' own Razorpay accounts without building subscription logic from scratch. - **Orchestrate marketplace seller onboarding and split payments** — Multi-vendor platforms can white-label sub-merchant onboarding by creating linked accounts, stakeholders, and product configurations via API, enabling programmatic KYC and automated fund routing to sellers. - **Reconcile settlements with your internal ledger** — Accounting and ERP SaaS can sync settlement data, transaction details, and fee breakdowns from Razorpay so their users get automated reconciliation without manual CSV exports. ## What you can build - **One-click payment link and QR code generation** — Let your users generate Razorpay payment links or dynamic QR codes directly from your app — ideal for field service, invoicing, or order management workflows. - **Unified customer and payment sync** — Use Truto's Unified Payment Gateway API to read and write Razorpay customers and payments through a standardized schema, making it easy to support Razorpay alongside other gateways. - **Automated payout disbursement pipeline** — Build a complete disbursement flow — create contacts, attach fund accounts (bank or UPI), and trigger payouts on schedule — all within your product using RazorpayX endpoints. - **Subscription lifecycle dashboard** — Create and manage Razorpay plans and subscriptions on behalf of your users, giving them a native in-app view of active, paused, and halted subscriptions without switching to the Razorpay dashboard. - **Embedded invoice and billing management** — Create, issue, update, and delete Razorpay invoices and line items from your SaaS, enabling your users to send professional invoices with integrated payment collection. - **Refund and dispute tracking center** — Surface refund statuses and dispute details inside your product by syncing Razorpay refunds and disputes, so your users can manage post-payment operations without context-switching. ## FAQs ### What authentication method does the Razorpay integration use? Razorpay uses HTTP Basic Auth with the Key ID and Key Secret. Your end users provide their Razorpay API credentials, and Truto securely stores and manages them for all subsequent API calls. ### Which Razorpay resources are covered by Truto's Unified Payment Gateway API? The Unified Payment Gateway API currently covers Customers and Payments. For all other Razorpay resources — orders, subscriptions, invoices, settlements, payouts, refunds, disputes, and more — you can use the Razorpay-specific proxy endpoints that Truto exposes. ### Can I both read and write data to Razorpay through Truto? Yes. The available tools support full CRUD where Razorpay's API allows it — including creating orders, customers, invoices, payouts, refunds, subscriptions, and linked accounts, as well as updating and deleting supported resources. ### Does Truto handle Razorpay's pagination automatically? Yes. Truto abstracts away Razorpay's cursor and skip/count-based pagination on list endpoints, so you get consistent paginated responses without managing offsets or cursors yourself. ### Can I manage RazorpayX (payouts and fund accounts) through this integration? Yes. The integration includes full support for contacts, fund accounts (bank and card), payouts, payout links, and transactions — covering the core RazorpayX disbursement workflow end to end. ### How do I handle Razorpay marketplace features like linked accounts and stakeholders? You can create, read, and update linked accounts, stakeholders, and product configurations through dedicated tools. This lets you build a complete white-labeled seller onboarding and KYC flow programmatically.