Manage Refunds

Managing refunds is a critical part of the ACH lifecycle — especially when it comes to reconciling financial activity, handling customer requests, and maintaining audit trails. The GrailPay Payments API provides a suite of endpoints to help you retrieve and review refund activity across different levels of granularity: from account-wide lists to individual refund records.

Whether you’re building a dashboard, troubleshooting a specific case, or simply auditing past refund activity, these endpoints give you the visibility and flexibility you need to stay on top of refund flows.

---

Available Actions

GrailPay currently supports the following operations for managing refunds:

• List all refunds with support for filtering and pagination
• Fetch all refunds associated with a specific transaction
• Retrieve details about a specific refund

---

List Refunds

To retrieve a list of refunds, use this endpoint to return all refund records associated with your account. This endpoint supports a rich set of query parameter filters, allowing you to refine results by transaction, merchant, status, amount, date range, ACH trace ID, and return code. Results are paginated and can be sorted by created date or amount.

This is especially useful for:

• Reconciling refunds across multiple transactions
• Tracking partial or multi-stage refund workflows
• Auditing refund history for a specific merchant or transaction
• Monitoring refund statuses and ACH return codes

For full request and response schemas, including available filters, refer to the List Refunds OpenAPI Documentation.

---

Retrieve a Specific Refund

Use this endpoint to fetch a single refund by its UUID, giving you detailed insight into a specific refund’s amount, status, related transaction, and any associated batch.

This is useful for:

• Troubleshooting issues with a specific refund
• Confirming refund success
• Displaying granular refund data in product interfaces

For full details, refer to our OpenAPI documentation:

• Fetch a Refund

---

Questions?

If you’re encountering any issues, please reach out to support@grailpay.com.

---