You can refund a fee mistakenly charged to a merchant or when client satisfaction hinges on the reimbursement of a fee or set of fees. When this happens, you must understand how to issue a fee refund quickly and correctly to provide the best client experience to your merchants. This tutorial shows you how to refund a fee that was previously processed and collected.
Audience: Partner
Refund a Fee
Ensure that you complete the prerequisites and all tasks in a section to issue the respective fee refund.
Notes
This process is only applicable to merchants on Net Billing. Merchants under Statement Billing cannot receive refunds through this process.
This process only applies to fees (fee entries) that have been fully processed and settled. Pending fee charges must be fully processed before a refund can be issued.
Prerequisites
Before attempting this tutorial, you must:
Meet the general prerequisites described in Get Started with Use Case Tutorials.
Understand the types of fees you can create and how to structure them.
Ensure your account has sufficient funds to issue the refund. Fee refunds can trigger a negative balance, which can cause additional platform fees and negative disbursements (or debits) to be assessed to your business account to cover the negative balance.
Issue a Fee Refund from the Transaction Details page
Select Payment History (under the Payments category).
Locate the transaction you’d like to refund fees for and select the listing to access the Transaction Details page for the transaction.
Click the Fees tab to reveal all related transaction fees for the associated transaction.

Click Refund located next to the specific fee entry you’d like to refund to the merchant.
Issue a Fee Refund from the Balance Details page
Select Merchants (under the Management category).
Find the merchant you want to refund and select the listing to access their profile page.
Click the merchant’s Account Balance tile to access their Balance Details page.
Locate the processed fee charge by referencing the date and event listed for each entry in the Entries section.
From the Entries section, click on a listed fee to reveal its Entry Details page.
From the Entry Details page, navigate to the Opposing Entry link, which will display the Entry Details page showing the fee amount that was deducted as a positive value.
Tip
When refunding the fee, always locate the “opposing entry,” the negative amount debited from the merchant, to ensure the fee amount you’re refunding is correct and the initial charge is aligned with the reason for the refund.
From that Entry Details page, click the Refund button in the lower left corner to reveal the Refund Amount dialog.
Enter the Fee amount (or a lesser amount for a partial fee refund), then click the dialog Refund button to complete the process and close the dialog.
Issue a Fee Refund from the Merchant Profile page
Select Merchants (under the Management category).
Find the merchant you want to refund and select the listing to access their Merchant Profile page.
Scroll down to the Profile menu and click the Fees tab to access the Merchant’s Fees page.
Locate the fee you want to refund under Active Fees and select it to access the Fees Details page.
Note
If the fee was charged using a no longer active fee, you can click Inactive Fees and follow the remaining steps to achieve the same result.
Scroll down to the Entries section and click the opposing entry’s listing to reveal its Entry Details page after verifying that you found the correct fee charge.
Note
If necessary, you can re-verify that the entry is correct before refunding by cross-referencing the entry on the Merchant’s Balance Details page or looking at each Entry listing’s Event field to find the matching fee event (fee schedule) description.
Click Refund at the bottom of the page to open the Refund dialog.
Use the pre-filled Refund Amount field value to issue a full refund or enter a lower amount to issue a partial refund. Then, click Refund to complete the fee refund.
Result: The refunded fee charge is immediately debited to the merchant’s available balance from your available balance. The Entry Details page for the fee charge will display as Refunded with a status badge next to the Entity Details page title to confirm the refund was issued.
You can verify the completion of the refund processing by accessing your Balance Details page and reviewing your Entries section. Verify processing completion on the Balance Details page using the following validation criteria:
The From Entity Name and From Entity ID field values display as the merchant name and merchant Entity ID that was originally assessed the fee.
The Description field auto-displays Refund for entry t1_etr_{yourRefundEntryId}.
The Event field auto-displays Entry Refund.
The Amount field is a negative amount matching the amount you refunded.
The Event ID matches the original fee charge Entry ID (for example, t1_etr_{originalFeeChargeEntryId}).