> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/refunds/create-refund.md).

# Create Refund

## Method and URL

<mark style="color:green;">`POST`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v1/refunds

## Request

**Request Body**

```json
{
    "clientReferenceId": "1755665477",
    "paymentSessionId": "44a14481-fa75-49a5-b17f-d03d8c5d52a6",
    "isFullAmount": false,
    "amount": { // Not required for Full Amount refund
        "value": "10000",
        "currency": "IDR"
    },
    "reason": "REQUESTED_BY_CUSTOMER",
    "description": "Customer didn't receive the Product",
    "method": "AUTO",
    "transferDestination": { // required if method = TRANSFER_ONLY
        "channelCode": "BCA",
        "channelInformation": {
            "accountNumber": "17677665415",
            "accountName": "Reforza Jordan Geotama"
        },
        "description": "Refund Pivot"
    },
    "metadata": {
        "notes": "Customer called support"
    }
}
```

**Detail Parameter Request**

<table><thead><tr><th width="212.58984375">Parameter</th><th width="132.98046875">Data Type</th><th width="114.7509765625">Character Limit</th><th width="119.09375">Requirement</th><th width="270.0029296875">Description</th></tr></thead><tbody><tr><td>Refund</td><td>Object</td><td>-</td><td>M</td><td><a data-mention href="/pages/WnR1nhAhT0SbDRPeWHEM">/pages/WnR1nhAhT0SbDRPeWHEM</a></td></tr></tbody></table>

## Response

**Response Body**

```json
{
    "code": "00",
    "message": "Success",
    "data": {
        "id": "01990e74-5bc9-79a5-a651-400af0ad13ef",
        "clientReferenceId": "1755665477",
        "paymentSessionId": "44a14481-fa75-49a5-b17f-d03d8c5d52a6",
        "chargeId": "110eb890-d238-4212-aedc-533a8c77a53e",
        "capturedAmount": {
            "currency": "IDR",
            "value": "10000.00"
        },
        "isFullAmount": true,
        "amount": {
            "currency": "IDR",
            "value": "10000.00"
        },
        "status": "PENDING",
        "reason": "REQUESTED_BY_CUSTOMER",
        "description": "Customer didn't receive the Product",
        "method": "AUTO",
        "transferDestination": {
            "channelCode": "BCA",
            "channelInformation": {
                "accountNumber": "17677665415",
                "accountName": "Reforza Jordan Geotama"
            },
            "description": "Refund Pivot"
        },
        "metadata": {
            "notes": "Customer called support"
        },
        "createdAt": "2025-09-03T07:22:10.761667115Z",
        "updatedAt": "2025-09-03T07:22:10.761667203Z"
    }
}
```

**Detail Parameter Response**

<table><thead><tr><th width="210.4765625">Parameter</th><th width="119.98046875">Data Type</th><th width="137.9453125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>Refund</td><td>Object</td><td>M</td><td><a data-mention href="/pages/WnR1nhAhT0SbDRPeWHEM">/pages/WnR1nhAhT0SbDRPeWHEM</a></td></tr></tbody></table>