> For the complete documentation index, see [llms.txt](https://central-bank-of-libya.gitbook.io/devportal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://central-bank-of-libya.gitbook.io/devportal/lypay/api-documentation/api-v1/webhooks.md).

# Webhooks

Webhook guidance for LYPay API v1 asynchronous notifications and transaction-status updates.

LYPay uses webhooks to send transaction notifications and status updates to participating banks and financial institutions.

{% hint style="info" %}
The webhook endpoint is **implemented and exposed by the participating bank or financial institution** so LYPay can deliver notifications securely.
{% endhint %}

## Purpose

Webhooks allow the institution to receive the final transaction outcome when processing cannot be completed within the immediate API response.

## When to use it

Use webhook handling when an API v1 payment returns an asynchronous or processing state and the final result will be delivered later.

## Integration role

1. The institution exposes the approved webhook endpoint.
2. LYPay processes the transaction.
3. LYPay sends the applicable transaction notification or status update.
4. The institution validates and processes the received event.

## Detailed API reference

[Open LYPay API v1 on Postman →](https://documenter.getpostman.com/view/30951400/2sA3JGfjN7)

## Related documentation

* [Technical Overview](/devportal/lypay/lypay-instant-payment-system-technical-overview.md)
* [Payments](/devportal/lypay/api-documentation/api-v1/payments.md)
* [About API v1](/devportal/lypay/api-documentation/api-v1/about-api-v1.md)