> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocka.live/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable webhook notifications

To receive notifications about payment status changes and other events, set up webhooks.

<Tip>
  You can use extended webhooks to receive extra metadata. For more details, see [Set up extended webhooks](/webhooks/set-up-extended-webhooks).
</Tip>

## Set up webhook notifications

Webhook notifications are available for three endpoints: [Create a payment](/api-reference/create-open-banking-payments), [Create a payout](/api-reference/payouts/create-a-payout) and [Create a payment link](/api-reference/shortlinks/create-a-payment-link).

To enable webhook notifications, pass `webhookUrl` in the request parameters.

```curl theme={null}
{
  "webhookUrl": "https://example.com/exampleURL"
}
```

<Accordion title="Sample webhook for a successful payment">
  ```json expandable lines theme={null}
  {
  "PaymentId":"bc973098-3dfb-4700-af20-28ca4fdb583a",
  "Status":"Done",
  "Signature":"b2e286bfc7b94ab2342342341881c85b50f286b23462436432d7dfc5fcd05ca2r234r231",
  "MerchantPaymentId":"12345678-1234-1234-1234-12345678910",
  "Reference":"M816254739082 IN",
  "Amount":50.0,
  "Currency":"EUR",
  "CardId":null,
  "Remitter":{
      "Name":"Max Mustermann",
      "Iban":"DE17500105179569697752",
      "SortCode":null,
      "AccountNumber":null
  },
  "AdditionalData":null,
  "DetailedInfo":null,
  "Method":"open-banking",
  "BankId":"sparkasse_de",
  "IsSenderBank":false,
  "BankTransactionId":"BANKTRANSACTIONID",
  "Settled":"Yes",
  "SettlementDate":"2024-10-01T07:18:56.316302Z"
  }
  ```
</Accordion>

## Alternative options

Apart from setting up webhook notifications, you can also receive up-to-date payment and payout data via `returnUrl` and status check endpoints. For more details, see [Retrieve payment details](/api-reference/retrieve-payment-details) and [Retrieve a payout](/api-reference/retrieve-payment-details/).
