> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developers.clearpay.co.uk/v-2/llms.txt
> - v1: https://developers.clearpay.co.uk/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.clearpay.co.uk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.clearpay.co.uk/_mcp/server.

# Refund object

## Attributes

| Attribute                 | Type                              | Description                                                                                                                                                                                                          |
| :------------------------ | :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `requestId`               | string                            | A unique request ID, required (in conjunction with `merchantReference`) for safe retries. It is recommended that the merchant generate a UUID for each unique refund.                                                |
| `amount`                  | [Money](/money-object) `required` | The refund amount.                                                                                                                                                                                                   |
| `merchantReference`       | string                            | The merchant's corresponding refund ID or reference, required (in conjunction with `requestId`) for safe retries.                                                                                                    |
| `refundId`                | string                            | The unique, Clearpay-generated refund ID.                                                                                                                                                                            |
| `refundedAt`              | string                            | A UTC timestamp of the refund creation time, in [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm) format.                                                                                                |
| `refundMerchantReference` | string                            | A unique reference for the individual refund event. If provided, the value will appear in the daily settlement file as "Payment Event ID". In most cases, this would hold the same value as the `merchantReference`. |

## Example Refund object

```json
{
  "requestId" : "c061b700-7f16-4a85-8289-2c1f017c8037",
  "amount" : {  
    "amount" : "10.00",
    "currency" : "GBP"
  },
  "merchantReference" : "merchantRefundId-1234",
  "refundId" : "67890123",
  "refundedAt" : "2019-01-01T00:00:00.000Z",
  "refundMerchantReference" : "merchantRefundId-1234"
}
```