The PhonePe Docs Developer Hub

Welcome to the PhonePe Docs developer hub. You'll find comprehensive guides and documentation to help you start working with PhonePe Docs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

Bulk Refunds

This section is for merchants who do refunds on a bulk basis through CSV upload.

🚧

Refund for merchants owned directly by the business is only allowed. I.e. a franchisor is not able to refund on behalf of the franchisees.

Upload .csv file containing the following fields.

Fields

Options

Description

merchant_id

mandatory

Registered merchant id at PhonePe

refund_transaction_id

optional

Unique transaction id for the refund transaction

amount

mandatory

Amount to be refunded in Rupees

provider_reference_id

mandatory if merchant_forward_transaction_id is not provided

PhonePe reference id of the forward transaction

merchant_forward_transaction_id

mandatory if provider_reference_id is not provided

Merchant transaction id of the forward transaction

merchant_order_id

mandatory

Order id associated with the refund transaction

message

optional

Message for the refund transaction. This will be shown to the customer along with the transaction details

provider_id

optional

The aggregator id assigned by PhonePe. This is applicable only for aggregators

Download a template document by clicking on ‘Download Sample Document’

For more details, click on the link below ‘Click here for more details on file format’.

The refund is processed by the system and once all the requested refunds are processed, a summary report is generated.

The summary provides:

  • Total number of refunds requested,
  • Count of successful refunds,
  • Count of refunds that failed due to other errors (e.g. network issue, etc),
  • Count of errors due to exceeding the allowable refundable amount (i.e. the original transaction is of a smaller amount than the requested refund, or if the partial refund is already processed and the allowable refund is lower than requested refund),
  • Amount successfully refunded.

Updated 3 years ago

Bulk Refunds


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.