Skip to content

Refund API · Guide

Refunds, reversals and chargebacks, explained

Money goes back to a customer in three different ways. A refund is your decision, after a payment succeeded. An auto-reversal happens on its own when a payment failed but the customer was debited. A chargebackis the customer disputing a payment through their bank. This guide explains each, then follows a refund from request to the customer's account: amounts, timing, statuses, failures, fees and how refunds are reconciled.

Three money paths

Three ways money can go back to a customer

Original payment · ₹2,450
RefundStarted by you, the merchant

After a successful payment: a return, a cancellation, a goodwill gesture

  1. Your business
  2. Payment provider
  3. Customer's bank or card
  4. Customer

Goes back the way the payment came. You decide the amount: full, partial, or several partials up to what was paid.

Auto-reversalAutomatic, by the bank or network

The payment failed, but the customer's account was debited anyway

  1. Customer's bank
  2. Payment never completed
  3. Customer

You don't issue it. RBI's turnaround-time framework sets the deadline, e.g. T+5 for a UPI or card payment to a merchant that wasn't confirmed.

ChargebackStarted by the customer, through their bank

The customer disputes a payment with their card issuer

  1. Your business
  2. Payment provider
  3. Card network
  4. Card issuer
  5. Customer

Raised against you, not by you. You respond with evidence; if the dispute goes your way, the amount comes back to you.

Illustrative. In every path the money ends with the customer. What differs is who starts it, when it happens, and whether you have a say.

Chapter 01

Refund, reversal, chargeback, void

These four terms get mixed up in support tickets all the time, and each one follows a different path. The difference that matters most is who starts it: you, the banking system, or the customer. That tells you whether you need to act, and whether acting would make things worse.

Four ways money is returned or never taken
Compared onRefundAuto-reversalChargebackVoid
Who starts itYouThe bank or network, automaticallyThe customer, through their card issuerYou or the provider
WhenAfter a successful paymentAfter a failed payment that debited the customerAfter a payment the customer disputesBefore a card payment is captured
Your roleDecide and request itNone: don't refund it as wellRespond with evidenceCancel the authorisation
Money pathBack through the original providerCustomer's bank returns itDebited from you, credited to the customerThe hold on the customer's card is released
Typical costDepends on your agreementNone to youThe amount, plus any fee your provider chargesUsually none

Chapter 02

The refund lifecycle

A refund has a short life. It is requested, checked, sent back through the provider, and then either lands or fails. The part customers care about, the credit showing in their account, happens last and outside your control.

From request to the customer's account
StepWhat happensWho controls it
1. RequestYou ask for a refund against the original payment, with an amount and a reason.You
2. CheckThe amount is checked against what's still refundable on that payment.The refund system
3. SubmitThe refund is sent to the provider that processed the original payment.The provider
4. ProcessThe provider passes it on through the card network or UPI to the customer's bank.Provider, network and bank
5. CreditThe customer's bank or card issuer posts the credit.The customer's bank
6. ReconcileThe refund is deducted from a settlement and matched to its original payment.You and the provider
  1. requested

    Accepted and checked against the refundable balance.

  2. processing

    Sent back through the provider; on its way to the customer's bank.

  3. processed

    Sent successfully. The customer's bank may still take time to show it.

  • failed ← from processing

    It couldn't be completed, with a reason. The money stays with you.

Typical refund states. Exact status names on Peneu are confirmed in the API reference.

Chapter 03

Full, partial and multiple refunds

A refund doesn't have to be the whole payment. One item comes back from a three-item order, or a customer downgrades mid-month, and you refund part of it. You can refund a payment several times, as long as the total never exceeds what was paid. That ceiling is what stops a double-click, or two support agents, from refunding twice.

Illustrative
One ₹2,450 payment, refunded in parts
RefundAmountRefundable beforeResultRefundable after
Item returned₹800.00₹2,450.00Accepted₹1,650.00
Delivery fee waived₹150.00₹1,650.00Accepted₹1,500.00
Second item returned₹1,600.00₹1,500.00Rejected: more than what's left₹1,500.00
Second item returned (corrected)₹1,500.00₹1,500.00Accepted₹0.00

Chapter 04

Where a refund goes

A refund goes back to the method the customer paid with, through the provider that processed the payment: to the same card, the same UPI-linked bank account, or the same bank account for netbanking. That's how refunds work across the industry, and it's what lets each party match the refund to the original payment.

It also means a refund can't be moved elsewhere. If the original account is closed, or you owe the customer money for something they didn't pay for, that isn't a refund. It's a payout to an account you verify first.

No failover for refunds

When a provider is slow, new paymentscan be routed to another provider. A refund can't: the money has to go back along the path it came. If the original provider is having problems, the refund waits for it. That's why failover helps collections but not refunds.

Chapter 05

How long the customer waits

"Processed" means the refund has left. When it shows up for the customer depends on where it is going, and each party in the chain sets its own pace. There's no single deadline for a refund you issue, so set the customer's expectation by method.

What decides when the customer sees the money
Paid withRefund goes toWhat sets the timing
UPIThe bank account linked to the UPI IDThe provider and the customer's bank. Usually the quickest
CardThe same cardThe card issuer posts the credit to the card account, which can take several working days
NetbankingThe bank account that paidThe customer's bank
WalletThe wallet balanceThe wallet provider

Give customers the method-specific expectation and a reference when you confirm the refund. It prevents most 'where's my refund?' follow-ups.

Chapter 06

Auto-reversals: money you don't refund

Sometimes a customer's account is debited but the payment never completes: the connection drops, the session times out, or the merchant never receives the confirmation. That's a failed transaction, and the money comes back on its own as an auto-reversal. RBI's turnaround-time framework sets deadlines for it, counted in calendar days from the transaction date (T), with compensation to the customer if the bank is late.

The framework covers failed transactions only. It doesn't cover refunds you choose to issue, or chargebacks.

RBI turnaround times for failed transactions that debited the customer (selected entries)
SituationAuto-reversal dueIf the bank is late
UPI payment to a merchant: debited, but the merchant didn't get the confirmationWithin T+5₹100 per day to the customer
Card payment at a shop: debited, but no charge slip was generatedWithin T+5₹100 per day to the customer
UPI or IMPS transfer: debited, but the beneficiary wasn't creditedBy T+1₹100 per day to the customer

Source: RBI circular RBI/2019-20/67 (20 Sep 2019). T is the calendar date of the transaction.

Check before you refund a 'failed' payment

When a customer says they were charged but the order failed, look up the payment first. If it failed, the money is already on its way back as a reversal, and refunding it too pays the customer twice. If it actually succeeded late, fulfil the order or refund it, but not both.

Chapter 07

Statuses, notifications and pending refunds

A refund's status changes after you ask for it, sometimes minutes later, sometimes longer. Rather than asking repeatedly, systems are usually told when the status changes, by a notification such as a webhook. Treat that notice as a prompt: look up the refund's current status before acting on it.

A refund that stays in processingisn't failed. Don't issue a second refund for the same amount while the first is still open; the ceiling on the refundable balance will usually stop it, and if it doesn't, the customer is paid twice.

Chapter 08

Why refunds fail

Most refunds go through. The ones that fail usually do so because the path back to the customer no longer exists.

What happenedUsual causeOn whose sideRetry on another route?What to tell the customer
Bank account closedThe account behind the UPI ID or netbanking payment has been closedCustomerPay another wayAsk for current bank details and send a payout
Card closed or replacedThe issuer can't post to the old cardIssuerDependsAsk the customer to check with their bank; the issuer may still route it
Payment too old to refundBeyond the window the provider or network allowsProviderPay another wayExplain and pay by payout to a verified account
Refund exceeds refundable balanceEarlier refunds already used it upYouCorrect amountNo impact; fix the amount
Provider unavailableAn outage at the original providerProviderWaitTell them it's queued, not lost

When the money can't go back the way it came, a payout to a verified account is the usual fallback.

Chapter 09

Chargebacks

A chargeback starts when a customer disputes a card payment with their card issuer, instead of asking you for a refund. The dispute travels through the card network to the provider and reaches you as a notice with a deadline to respond. The rules and time limits come from the card network and your provider.

If you have evidence the customer got what they paid for, such as a delivery confirmation, a signed-for parcel, usage logs or a clear cancellation policy they accepted, you submit it. If the decision goes your way, the amount comes back to you. If not, it stays with the customer.

How to keep chargebacks rare
HabitWhy it helps
Refund quickly when the customer is rightA customer who gets a refund has no reason to dispute
Use a business name customers recognise on their statementsMany disputes are 'I don't recognise this charge'
Keep delivery and usage evidence for every orderYou can only win with evidence
Make cancellation and refund terms easy to find before paymentFewer 'I didn't agree to this' disputes
Watch the settlement adjustmentsChargeback debits show up there, often before you've read the notice

Chapter 10

Fees on refunds

The customer always gets back the amount you refund. The open question is what happens to the fee you paid on the original payment. Some providers return it when you refund, some keep it, and some charge a separate fee for handling refunds or chargebacks. It depends on your provider and agreement, so check before you plan refund-heavy promotions.

Illustrative
  1. Refund to the customer₹2,450.00
  2. Original fee at an illustrative 2%Returned or kept, depending on the provider₹49.00 + GST
  3. Your cost if the fee is kept₹49.00 + GST
One ₹2,450 payment refunded in full, with an illustrative 2% fee. Whether the fee comes back depends on your agreement.

Chapter 11

Reconciling refunds

Refunds rarely arrive as separate debits. They are deducted from a settlement as negative lines against their original payments. Reconciling them means proving that every refund you asked for was deducted once, and only once.

The refund match
MatchOn whatWhat a mismatch means
Refund request ↔ refundYour own reference, such as the return or RMA numberA refund asked for but never created, or created twice
Refund ↔ original paymentThe payment IDA refund you can't explain to finance or the customer
Refund ↔ settlement lineThe refund's reference and amountA refund not deducted yet, or deducted twice

How Peneu matches refunds across providers: reconciliation.

Chapter 12

Talking to customers

Most refund complaints aren't about the money. They're about not knowing where it is. A short message at each stage, with a reference, answers the question before it's asked.

Your written refund and cancellation policy also matters, both for customers and under consumer-protection rules for online sellers. What it has to include is a legal question; check it with your adviser.

What to tell the customer, and when
WhenWhat to tell them
You approve the refundThe amount, the method it's going back to, and when to expect it for that method
The refund is processedThe date, and a reference their bank can trace
It hasn't arrived after the expected timeAsk them to check with their bank using the reference; card refunds are traced by the issuer
The refund failedWhy, and how you'll pay them instead

Chapter 13

Integration considerations

Refunds can be issued from a dashboard by support staff or from your own systems. For system-issued refunds, a few habits keep them safe:

  • Always refund against the original payment's ID, and record a reason.
  • Use your own reference, such as the return number, so a retried request can't create a second refund.
  • Check the refundable balance before offering a refund in your own interface.
  • Treat notifications as prompts, and look up the refund's status before updating the order.
  • Never issue a second refund while the first is still processing.
For developers

Illustrative pseudo-code: the flow, not Peneu's API. Field and event names are confirmed in the API reference.

Illustrative
refund = create_refund(payment_id, amount, reason = "item_returned", reference = "RMA-5521")
save(refund.id, refund.status)

on status_update(notice):
    status = get_refund(notice.refund_id).status   # confirm before acting
    if status == processed: tell_customer(refund, reference)
    if status == failed:    offer_payout_to_verified_account()
    else:                   wait()                  # don't refund again

Chapter 14

Refunds by business type

The mechanics are the same everywhere. What changes is why refunds happen and how the amount is decided.

FAQ

Refund questions

What is the difference between a refund and a reversal?

A refund is money you choose to return after a successful payment. A reversal happens automatically when a payment failed but the customer's account was debited; you don't issue it.

What is a chargeback?

A dispute the customer raises with their card issuer. It is started against you, not by you, and you respond with evidence such as proof of delivery.

Can I refund part of a payment?

Yes. You can refund part of a payment, and make several partial refunds, as long as the total doesn't exceed the amount paid.

Can a refund go to a different account or card?

Normally no. A refund goes back to the original payment method through the provider that processed it. Paying someone elsewhere is a payout, not a refund.

How long does a refund take to reach the customer?

It depends on the payment method and the customer's bank. UPI refunds are usually the quickest; card refunds depend on when the issuer posts the credit, which can take several working days.

Does RBI set a deadline for refunds?

RBI's turnaround-time framework sets deadlines for failed transactions, which are auto-reversed, for example T+5 for a UPI or card payment to a merchant that wasn't confirmed. It doesn't cover refunds a merchant chooses to issue.

A customer says they were charged for a failed payment. Should I refund it?

Check the payment first. If it failed, the money comes back as an auto-reversal and a refund would pay them twice. If it actually succeeded, deliver the order or refund it.

What does 'processed' mean for a refund?

That the refund has been sent back through the provider. The customer sees it once their bank or card issuer posts the credit, which can be later.

Why did a refund fail?

Usually because the original account or card is closed or changed, or because the payment is too old for the provider to refund. The money stays with you, and you can pay the customer another way.

Do I get the original payment fee back when I refund?

It depends on your provider and agreement. Some return the fee on a refund, others keep it. Check before you plan refund-heavy promotions.

How do refunds show up in settlement?

They are netted from a settlement batch as negative lines against their original payments, so a short credit usually means refunds were deducted.

What should I tell a customer who is waiting for a refund?

The amount, the date it was processed, the method it's going back to, and the reference. For card refunds, a reference the issuer can trace saves a second enquiry.

Take refunds out of the support queue

Tell us how refunds work in your business today. We'll show you what the flow looks like end to end, from request to reconciliation.