> 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/account-and-balance/withdrawal/withdrawal-callback.md).

# Withdrawal 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": "WITHDRAW.SUCCESS",
  "data": {
    "id": "7f0485cf-4289-40b4-9a0d-80f182b914fd",
    "merchantId": "e485e01b-ff59-4a47-bb7d-9b39064f3388",
    "withdrawal": {
      "referenceId": "Reforza-Pivot-001",
      "withdrawType": "BANK_ACCOUNT",
      "balanceType": null,
      "isFullAmount": false,
      "amount": {
        "currency": "IDR",
        "value": "1000000"
      },
      "description": "Reforza Pivot 001"
    },
    "status": "SUCCESS",
    "createdAt": "2025-08-07T07:29:13.962421067Z",
    "updatedAt": "2025-08-07T07:29:13.962421155Z"
  }
}
```

**Detail Parameter Request**

<table><thead><tr><th width="217.5302734375">Parameter</th><th width="120">Data Type</th><th width="134.3671875">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>event</td><td>String</td><td>M</td><td><p>Withdrawal Event Names:<br></p><ol><li>WITHDRAW.SUCCESS</li><li>WITHDRAW.FAILED</li></ol></td></tr><tr><td>data</td><td>Object</td><td>M</td><td>Response Data from Pivot contains <a data-mention href="/pages/a2Xg4hBQFePwe8ub5kXn">/pages/a2Xg4hBQFePwe8ub5kXn</a></td></tr></tbody></table>