Refresh Installment API
Refresh an instalment to get its latest debit status.
Request
Response{ "error": false, "status": "SUCCESS", "data": { "mandate_status": "…", "instalment_schedule_and_debit_results": "…" }}
Illustrative example. Exact parameters are listed in your dashboard docs.
How it works
What you send and what you get back
Set up and manage recurring payments with e-mandates. Create, refresh, cancel and track mandates and their instalments, and retry or skip debits, all through APIs.
You send
- Customer bank details
- Amount, frequency and dates
- Mandate or instalment ID
You get back
- Mandate status
- Instalment schedule and debit results
Why Shadoweye
Built for production from day one
Real-time results
Responses come back in milliseconds, so the check fits inline in your signup or approval flow.
Clean, consistent JSON
Every Shadoweye API returns the same response envelope. Parse it once and reuse it everywhere.
One key for every API
Use the same API key for the Refresh Installment API and every other API in the catalogue. No extra contracts.
Pay per call
Calls are charged from your prepaid wallet. No monthly fee and no minimum commitment.
Secure by default
All traffic runs over HTTPS and every request is authenticated with your secret key.
Full audit trail
Every call and deduction is recorded in your dashboard ledger for reconciliation and audits.
Use cases
Where teams use the Refresh Installment API
Loan EMIs
Collect repayments automatically.
Subscriptions
Bill customers on a schedule.
Insurance premiums
Automate recurring premium collection.
SIPs
Run recurring investments.
Get started
Go live in four steps
Create your account
Sign up and get a live API key from your Shadoweye dashboard.
Add funds
Top up your prepaid wallet securely with UPI, card or net banking.
Test it live
Try the Refresh Installment API with real data in the Live Tester before you write code.
Call the API
Send a POST request with your key in the X-Shadoweye-Api-Key header and use the JSON response.
FAQ
Frequently asked questions
What is the Refresh Installment API?
Refresh an instalment to get its latest debit status. It is part of the Shadoweye E-Mandate API Services family and is available through a single REST API key.
What do I need to send to the Refresh Installment API?
Typical inputs are: Customer bank details; Amount, frequency and dates; Mandate or instalment ID. The exact parameters for this API are listed in your dashboard documentation.
What does the Refresh Installment API return?
You receive a JSON response that typically includes: Mandate status; Instalment schedule and debit results.
How much does the Refresh Installment API cost?
Calls are charged per request from your prepaid Shadoweye wallet at the rate shown in your dashboard. There are no monthly fees or minimum commitments.
How do I get started?
Create a free account, add funds to your wallet, copy your API key and test the API in the Live Tester. Most teams go live the same day.
Is my data secure?
All requests use HTTPS, are authenticated with your secret API key and are recorded in your audit ledger. Only send personal data you are permitted to process, with the customer's consent where required.
Related E-Mandate API Services
View allE-Mandate
Register an e-mandate for recurring debits from a customer's bank account.
Create Mandate
Create a new mandate with amount, frequency and validity.
Refresh Mandate
Refresh a mandate to get its latest registration status.
Delete Mandate
Delete a mandate that is no longer required.
Cancel Mandate
Cancel an active mandate and stop future debits.
Get Mandate
Fetch the details and status of a mandate.
Get Mandate Installment
Get the instalment schedule for a mandate.
Get Installment By Mandate
List all instalments raised under a mandate.