Available Actions
GrailPay currently supports the following operations for managing refunds:- Retrieve details of a specific batch refund
- List all batch refunds with support for filtering and pagination
- Fetch all refunds associated with a specific transaction
- Retrieve details about a specific refund
Retrieve a Batch Refund
You can retrieve a specific batch refund by using its unique UUID. This endpoint returns all key information for the batch — including refund amount, status, processing timestamps, and linked transactions. This is useful when auditing or reviewing the outcome of a large-scale reversal. For full details, refer to our OpenAPI documentation:List All Batch Refunds
This endpoint allows you to fetch a list of all batch refunds, with support for filtering by status, date range, and more. Results are paginated to support large datasets and can be sorted to help you find recent activity quickly. This is ideal for:- Reconciling large volumes of refund activity
- Exporting historical refund records
- Powering internal reporting dashboards
Retrieve All Refunds for a Transaction
To understand the full refund history for a particular transaction, use this endpoint to retrieve all refund objects linked to a given transaction UUID. This helps teams confirm how much has been refunded, when, and in how many parts. This is especially helpful for:- Partial refunds
- Multi-stage refund workflows
- Auditing returned funds
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