# Request Web Hook

{% hint style="info" %}
The Request Webhook is required for [API Only](https://docs.inqud.com/crypto-widget/overview/api-acquiring-overview) integrations. For those utilizing [Inqud Hosted](https://docs.inqud.com/crypto-widget/overview/inqud-hosted-page-overview) or [Embedded Widget](https://docs.inqud.com/crypto-widget/overview/embedded-widget-overview) options, please visit [Checkout Web Hook](https://docs.inqud.com/crypto-widget/integration/web-hooks/checkout-web-hook) page.
{% endhint %}

{% hint style="info" %}
For foundational information on webhooks, including key concepts and verification methods, please refer to the [Webhook Basics](https://docs.inqud.com/developer/web-hooks) page.
{% endhint %}

Request Web Hooks enable merchant systems to receive timely notifications regarding status changes of Checkouts.

Learn more about requests:

{% content-ref url="../../explore/requests" %}
[requests](https://docs.inqud.com/crypto-widget/explore/requests)
{% endcontent-ref %}

### Prerequisites

* Your business account with Inqud is set up.
* The Crypto Widget has been established and configured within the Inqud platform.
* The Crypto Widget is active.

### Setting up Web Hook

* Open the [app](https://app.inqud.com/) and sign in.
* From the left menu bar, choose "Crypto widgets".
* Select the desired widget.
* Open "Webhooks"
* Locate the "Request webhook" option and click on "Add".
* Enter the required details:
  * Webhook link: Provide the URL of your webserver that will handle the callbacks.
  * Webhook secret: Enter a secret key for signature calculation (optional).
* Click on "Save" to finalize your settings.

### Request statuses

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FCQtouOzz0VrKGwL7CZlY%2Fimage.png?alt=media&#x26;token=6dc89fc4-182d-4e02-a112-4585c2ffc039" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Visit the [Requests page](https://docs.inqud.com/explore/requests#request-statuses) to learn more about the various request statuses.
{% endhint %}

### Notification

The Request Web Hook activates with every transition in request status. It requires your web server to respond with a 200 status code. If a different status code is returned, the Web Hook will attempt retries multiple times, using an exponential back-off strategy.&#x20;

For detailed request specifications, please refer to the following page:

[Request Web Hook Specification](https://apireference.inqud.com/#tag/crypto-acquiring-webhooks/operation/user_crypto-acquiring_create-request-webhook) (see **Callbacks** sections)