> For the complete documentation index, see [llms.txt](https://passimpay.gitbook.io/passimpay-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://passimpay.gitbook.io/passimpay-api/exchange/webhook.md).

# Webhook exchange

The notification URL is specified in the platform settings in the personal account.

The notification is sent only after a successful incoming transaction.

**After all actions are completed, a response with a 200 status must be returned. Otherwise, there will be 2 additional attempts to resend the notification.**

**Ensure that the signature is verified for security purposes.**

#### Headers

<table><thead><tr><th width="191">Name</th><th width="151">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>x-signature</code></td><td>string</td><td>SHA-256 encrypted signature</td></tr><tr><td><code>Content-Type</code></td><td>string</td><td>application/json</td></tr></tbody></table>

#### Request Body

<table data-full-width="false"><thead><tr><th width="226">Name</th><th width="140">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>type</code></td><td>string</td><td>The type of callback, for example, <code>exchange</code></td></tr><tr><td><code>platformId</code></td><td>integer</td><td>Your Platform ID</td></tr><tr><td><code>exchangeId</code></td><td>integer</td><td>The unique identifier of the created exchange order.</td></tr><tr><td><code>paymentFromId</code></td><td>integer</td><td>Currency ID. You can get the list of currency IDs <a href="https://passimpay.gitbook.io/passimpay-api/list-of-cryptocurrencies">here</a>.</td></tr><tr><td><code>paymentToId</code></td><td>integer</td><td>Currency ID. You can get the list of currency IDs <a href="https://passimpay.gitbook.io/passimpay-api/list-of-cryptocurrencies">here</a>.</td></tr><tr><td><code>give</code></td><td>string</td><td>The amount of currency you are providing for the exchange.</td></tr><tr><td><code>receive</code></td><td>string</td><td>The estimated amount of currency you will receive after the exchange.</td></tr></tbody></table>
