Overview
With Notch Pay’s refund functionality, you can:- Issue full or partial refunds for completed payments
- Track the status of refunds
- Receive notifications when refunds are processed
- View refund history for reconciliation
Key Benefits
- Simple API for processing refunds
- Support for partial refunds
- Automatic handling of refund logistics
- Detailed refund tracking
- Webhook notifications for refund events
Use Cases
- Customer returns or cancellations
- Service delivery issues
- Billing adjustments
- Dispute resolutions
- Promotional refunds or credits
Processing Refunds
From the Dashboard
The easiest way to process a refund is through your Notch Pay dashboard:- Log in to your Notch Pay Business suite
- Go to Payments > Refunds
- Find the payment you want to refund
- Click the Refund button
- Enter the refund amount (for partial refunds) or select Full Refund
- Add a reason for the refund (optional)
- Click Process Refund
Using the API
You can also process refunds programmatically using the API:Refund Types
Full Refunds
A full refund returns the entire payment amount to the customer:Partial Refunds
A partial refund returns only a portion of the payment:Refund Statuses
Refunds can have the following statuses:Status | Description |
---|---|
pending | The refund has been initiated but not yet processed |
processing | The refund is being processed by the payment provider |
complete | The refund has been successfully processed |
failed | The refund could not be processed |
Retrieving Refunds
Retrieving a Single Refund
To retrieve information about a specific refund:Listing Refunds for a Payment
To retrieve all refunds for a specific payment:Listing All Refunds
To retrieve all refunds for your account:Refund Webhooks
To receive notifications about refund events, set up webhooks for the following events:refund.created
: A refund has been createdrefund.complete
: A refund has been successfully processedrefund.failed
: A refund has failed
Refund Limitations
When processing refunds, be aware of the following limitations:- Time Limits: Refunds can typically be processed within 90 days of the original payment
- Payment Method Restrictions: Some payment methods may have restrictions on refunds
- Processing Time: Refunds may take several days to process, depending on the payment method
- Fees: While Notch Pay doesn’t charge additional fees for refunds, the original processing fees are typically not refunded
Best Practices
- Clear Refund Policy: Establish a clear refund policy for your customers
- Prompt Processing: Process refunds promptly to maintain customer satisfaction
- Detailed Records: Keep detailed records of refund reasons for reconciliation
- Communication: Keep customers informed about the status of their refunds
- Partial Refunds: Consider offering partial refunds when appropriate
- Metadata: Use metadata to link refunds to your internal systems
Troubleshooting
Common Issues
- Insufficient Funds: Ensure your Notch Pay account has sufficient funds to process the refund
- Invalid Payment: Verify that the payment ID or reference is correct
- Payment Not Eligible: Check that the payment is in a state that allows refunds
- Amount Exceeds Payment: Ensure the refund amount doesn’t exceed the original payment amount
Support
If you encounter issues with refunds:- Check the API Reference for detailed parameter documentation
- Contact our support team for assistance