Get Mandate Installment API – Fetch EMI, Subscription & Auto-Debit Details Instantly
The Get Mandate Installment API enables businesses to fetch real-time installment details linked to active mandates such as EMI payments, subscription billing cycles, and auto-debit transactions. Designed for fintech platforms, NBFCs, and SaaS businesses, this API provides accurate installment schedules, payment status, due dates, and transaction history. With high reliability, secure architecture, and seamless integration, businesses can automate payment tracking and improve customer experience while reducing manual reconciliation efforts.
AUTOFLOW
E-Mandate APIMaximum Limit
₹ 25,000/cycle
Frequency
MONTHLY
Start Date
17 APR 2026
Status
ACTIVE
HDFC Bank Ltd.
XXXX XXXX 8821
{
"mandate_id": "EM_4409X",
"type": "ON_DEVICE_AUTH",
"config": {
"max_amount": 25000.00,
"recurrence": "MNTH",
"secure_hash": "AES_GCM_256"
}
}
NPCI_ONBOARDED
Digital India Stack 2026
Get Mandate Installment API
Access precise schedules and breakdown of recurring payment installments. Gain granular visibility into upcoming collections, payment cycles, and individual transaction status within a mandate.
1. Schedule Query
Input the Mandate ID to request the specific installment roadmap and historical payment logs associated with the instruction.
2. Cycle Processing
Our system computes the installment sequence, calculating dates and amounts based on the registered frequency and mandate limits.
3. Installment Feed
Get a detailed JSON response featuring installment numbers, scheduled dates, debit amounts, and current execution status.
Granular Installment Tracking
Manage your cash flow with unprecedented detail. The Get Mandate Installment API provides the data depth required to forecast and reconcile every single debit.
Upcoming Due Dates
Identify the exact date for the next scheduled installment to trigger timely pre-debit notifications to customers.
Amount Per Cycle
Verify the specific amount to be debited for each installment, ensuring it aligns with the customer's subscription plan.
Installment Count
Track the total number of installments authorized versus the number of successful debits processed to date.
Payment History
Access a historical log of previous installments to identify patterns in successful collections or payment failures.
Settlement Status
Check the real-time settlement status of individual installments to reconcile your ledger with actual bank credits.
Forecasting Accuracy
Utilize structured installment data to build accurate revenue forecasts based on active mandate schedules.
Dispute Resolution
Resolve customer queries faster by providing specific details regarding which installment was debited and when.
End-of-Term Visibility
Clearly see when the final installment is due, allowing for automated renewal workflows or service termination.
Compliance Audit
Ensure every debit matches the pre-defined installment schedule registered during the mandate setup.
Advanced Installment Tracking
Our Get Installment API provides the specific transaction-level intelligence needed to manage complex recurring billing schedules with absolute precision.
Schedule Schema
Access comprehensive installment data points including due dates, cycle numbers, and specific amount breakdowns per debit.
Payment Logs
Securely retrieve the status of individual installments to distinguish between settled, pending, and failed collection attempts.
Cycle Analysis
Review the progression of your mandate installments to monitor remaining balances and upcoming billing requirements.
Why Use Installment API?
Operational efficiency relies on knowing exactly when funds will be collected. Use the Installment API to map out your revenue pipeline and ensure every individual debit aligns perfectly with your customer's authorization.
Fetch Installment Schedules in Real-Time
Retrieve granular payment cycle data and installment breakdowns with a simple GET request. Access payment history and future collection dates instantly.
curl --request GET
--url https://api.idspay.in/v3/mandate/installments
--header 'Authorization: Bearer YOUR_API_KEY'
--header 'Content-Type: application/json'
--data '{
"mandate_id": "MND_987654321"
}'{
"status": "SUCCESS",
"data": {
"mandate_id": "MND_987654321",
"total_installments": "12",
"paid_count": "3",
"next_due_date": "2026-05-10",
"installment_amount": "1500.00",
"currency": "INR"
}
}🔍 Precision of Installment API
Empower your finance team with deep insights into every payment cycle. Validate installment counts and scheduled amounts before every collection attempt.
Cycle Schedule
Fetch precise installment dates directly from the payment roadmap for total billing certainty.
Count Tracking
Access the exact number of successful installments processed versus total remaining cycles.
Amount Audit
Verify exactly what installment amount is due to prevent over-billing or under-collection.
Due Date Alerts
Integrate next-due-date checks into automated reminder workflows for better success rates.
Payment History
Monitor previous installment success patterns and identify payment behavior trends.
Balance View
Retrieve the outstanding balance and collected amount for precise financial reconciliation.
Sequence Mapping
Understand which installment in the series is currently being processed with ease.
Yield Analytics
Get standardized installment data to calculate customer lifetime value and churn risks.
How Installment API Works
Seamlessly fetch the entire payment roadmap for a mandate, tracking every scheduled debit and successful collection cycle in real-time.
Identifier Input
Provide the Mandate ID to initiate a request for the complete installment schedule and payment history.
Schedule Sync
Our API queries the ledger to retrieve all past, pending, and upcoming installment dates and amounts.
Cycle Analysis
The engine processes the sequence to identify the current installment number and remaining collection limits.
Granular Report
Receive a structured installment feed to update your billing cycles and customer payment projections.
Optimize Recurring Revenue with Mandate Installment API
Our Installment API is designed to provide granular cycle visibility, allowing you to track exactly which installment of a mandate is currently active.
To achieve precise revenue forecasting, businesses need deep data on payment success per installment. Our API pulls comprehensive history and future schedules directly from the mandate lifecycle.
Whether you are reconciling previous debits, validating the next collection amount, or managing term-based subscriptions, this Ledger Engine provides the transactional detail required for professional-grade billing management.
Installment Data Sync Success
History
Next Due
Why IDSPay is Better than Other Installment APIs?
See how our cycle tracking outperforms industry standards.
Instant Cycle Updates
Retrieve current installment counts with lower latency than traditional status APIs.
Superior Accuracy
More precise ledger reconciliation than Eko & API Mall for subscription tracking.
Developer-First Docs
Simplified installment logic mapping compared to the complex structures of Digitap.
Scalable Pricing
Low-cost per-query pricing designed to support high-volume recurring billing startups.
Integration Support
Direct access to fintech engineers to help you map complex installment schedules 24/7.
Why We Are The Better Choice
Compare our performance and see why top fintechs trust our infrastructure.
| Feature | 🚀 Our API | Other Providers |
|---|---|---|
| Accuracy |
99.9% (Govt. Direct)
|
~85-90% (Scraped)
|
| Speed |
< 500ms
|
2 - 5 Seconds
|
| Pricing |
Pay-per-use (No Fixed Fee)
|
High Monthly Commitment
|
| Support |
24/7 Priority Support
|
Email-only (48hr TAT)
|
* Based on internal benchmark tests and competitor analysis (April 2026).
Frequently Asked Questions
Common developer queries about the Get Mandate Installment API and payment cycle tracking.
What is the Get Mandate Installment API?
The Get Mandate Installment API is a specialized endpoint that provides a detailed breakdown of a mandate's payment schedule. It retrieves the status of past installments, specific due dates for future cycles, and the total collection progress.
2. When should I use the Installment API?
Use this API when you need to confirm which installment number is currently due, reconcile successful versus failed payments in a series, or provide a customer with their upcoming billing roadmap.
3. Does it show the status of individual payments?
Yes. The API returns an array of installment objects, each indicating whether that specific cycle was 'Settled', 'Failed', or is still 'Upcoming' in the schedule.
4. Can I see the remaining collection limit?
Yes, the response provides total authorized amount versus the amount already collected, helping you calculate the remaining headroom for future installments.
5. What if an installment was partially paid?
The API tracks the exact amount collected per cycle. If your business logic allows variable amounts, the response will reflect the specific value debited for that particular installment number.
6. How does the API handle ad-hoc installments?
For 'As and When Presented' mandates, the API provides a chronological log of every debit presentation attempt, allowing you to track frequency and total volume without a fixed calendar schedule.
7. Can I identify the next collection date?
Yes. The API explicitly flags the 'next_due_date' based on the registered frequency, enabling you to trigger automated pre-debit SMS or Email notifications to your users.
8. Does it provide UMRN-level transaction mapping?
Yes. Every installment entry is mapped back to the mandate's UMRN, ensuring that your financial audits and bank-side reconciliations remain perfectly synchronized.
9. How are failed installments displayed?
Failed installments are returned with a specific failure reason and the original attempt timestamp, allowing your system to decide whether to re-attempt the debit or skip to the next cycle.
10. Is the installment data updated in real-time?
Yes. As soon as a transaction response is processed by our gateway, the installment ledger is updated. You can query this API to get the most current view of your recurring revenue pipeline.