# Refund Callback

## Method and URL

<mark style="color:green;">`POST`</mark> [www.yourcompany.com/payment\\\_callback\\\_url](http://www.yourcompany.com/payment\\_callback\\_url)

## Request

**Header Request**

<table><thead><tr><th>Parameter </th><th width="117">Data Type</th><th width="131">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>X-API-Key</td><td>String</td><td>M</td><td>Callback API Key, an additional API Key used specifically for receiving callbacks</td></tr><tr><td>Content-Type</td><td>String</td><td>M</td><td>application/JSON</td></tr><tr><td>Accept</td><td>String</td><td>M</td><td>application/JSON</td></tr></tbody></table>

**Request Body**

```json
{
  "event": "REFUND.SUCCESS",
  "data": {
    "id": "01990e4f-bb8d-7e3d-ba3f-463176c925e8",
    "clientReferenceId": "1755054798",
    "paymentSessionId": "edb4e7c4-7842-4ec6-831a-f85c5bbdf3a4",
    "chargeId": "4f5eebdd-00ba-4202-b6ed-7056c1865f2d",
    "capturedAmount": {
      "currency": "IDR",
      "value": "10000.00"
    },
    "isFullAmount": false,
    "amount": {
      "currency": "IDR",
      "value": "500.00"
    },
    "status": "SUCCESS",
    "reason": "REQUESTED_BY_CUSTOMER",
    "description": "Refund due to duplicate transaction",
    "destinationType": "ACCOUNT",
    "method": "AUTO",
    "transferDestination": {
      "channelCode": "BCA",
      "channelInformation": {
        "accountNumber": "17677665415",
        "accountName": "Reforza Jordan Geotama"
      },
      "description": "Refund Pivot"
    },
    "metadata": {
      "notes": "Customer called support"
    },
    "createdAt": "2025-09-03T06:42:10Z",
    "updatedAt": "2025-09-03T06:42:13Z"
  }
}
```

**Detail Parameter Request**

<table><thead><tr><th width="196.24609375">Parameter</th><th width="120">Data Type</th><th width="128">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>event</td><td>String</td><td>M</td><td><p>List of Event Names:</p><ol><li>REFUND.PENDING</li><li>REFUND.WAITING_BANK_TRANFER</li><li>REFUND.SUCCESS</li><li>REFUND.FAILED</li></ol></td></tr><tr><td>Refund</td><td>Object</td><td>M</td><td><a data-mention href="refund-object">refund-object</a></td></tr></tbody></table>