> 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/readme.md).

# Central Bank of Libya Developer Portal

Official Central Bank of Libya technical documentation for national payment and financial integrations.

### Official technical documentation for national financial integrations

Welcome to the **Central Bank of Libya (CBL) Developer Portal** — the official resource for banks, licensed financial institutions, and integration teams connecting to CBL digital financial infrastructure.

{% hint style="info" %}

## Build with CBL financial infrastructure

Use this portal to access system overviews, integration guidance, API documentation, security requirements, and supporting technical references.
{% endhint %}

## Start here

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-bolt" style="color:$primary;">:bolt:</i></h3></td><td><strong>LYPay Instant Payment System</strong></td><td>Explore Libya's instant payment system, integration model, settlement information, and technical documentation.</td><td><a href="/devportal/lypay/lypay-instant-payment-system.md">LYPay Instant Payment System</a></td></tr><tr><td><h3><i class="fa-address-card" style="color:$primary;">:address-card:</i></h3></td><td><strong>National Alias Directory</strong></td><td>Access NAD overview, alias-directory integration guidance, and the official NAD API documentation.</td><td><a href="/devportal/national-alias-directory-nad.md">National Alias Directory (NAD)</a></td></tr><tr><td><h3><i class="fa-code" style="color:$primary;">:code:</i></h3></td><td><strong>API Documentation</strong></td><td>Go directly to LYPay API documentation, authentication, payment APIs, transaction status, and webhooks.</td><td><a href="/devportal/lypay/api-documentation.md">API Documentation</a></td></tr><tr><td><h3><i class="fa-shield-halved" style="color:$primary;">:shield-halved:</i></h3></td><td><strong>Regulatory &#x26; Compliance</strong></td><td>Review regulatory, security, and compliance guidance relevant to LYPay integrations.</td><td><a href="/devportal/lypay/regulatory-guidelines-and-compliance.md">Regulatory Guidelines &amp; Compliance</a></td></tr><tr><td><h3><i class="fa-envelope" style="color:$primary;">:envelope:</i></h3></td><td><strong>Contact &#x26; Support</strong></td><td>Find the official support channel for DevPortal and integration-related inquiries.</td><td><a href="/devportal/contact-and-support.md">Contact &amp; Support</a></td></tr></tbody></table>

## National payment infrastructure

{% columns %}
{% column width="50%" %}

### LYPay — Instant Payment System

{% hint style="success" %}
**Available now**
{% endhint %}

Real-time, secure, and scalable instant payments between participating financial institutions, with APIs supporting funds transfers, merchant payments, and alias-based transactions.

[Explore LYPay →](/devportal/lypay/lypay-instant-payment-system.md)
{% endcolumn %}

{% column width="50%" %}

### NAD — National Alias Directory

{% hint style="success" %}
**Available now**
{% endhint %}

A standardized national directory supporting alias registration, lookup, verification, and interoperable alias-based account identification across participating institutions.

[Explore NAD →](/devportal/national-alias-directory-nad.md)
{% endcolumn %}
{% endcolumns %}

## What's next

{% hint style="success" icon="sparkles" %}

### E-Commerce Payments

**Coming Soon**
{% endhint %}

## Developer journey

{% stepper %}
{% step %}

### Review the documentation

Start with the relevant system overview, integration model, and API reference.
{% endstep %}

{% step %}

### Prepare the development environment

Request the required access and prepare approved connectivity and security controls.
{% endstep %}

{% step %}

### Integrate and validate

Implement the required APIs, authentication, webhooks, error handling, and transaction flows.
{% endstep %}

{% step %}

### Prepare for production

Complete validation, operational readiness, monitoring, reconciliation, and production-readiness activities.
{% endstep %}
{% endstepper %}

## Documentation areas

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-book-open" style="color:$primary;">:book-open:</i></h3></td><td><strong>Technical Documentation</strong></td><td>Architecture, payment flows, settlement, QR standards, and system overviews.</td><td><a href="/devportal/lypay/lypay-instant-payment-system-technical-overview.md">LYPay Instant Payment System — Technical Overview</a></td></tr><tr><td><h3><i class="fa-code-branch" style="color:$primary;">:code-branch:</i></h3></td><td><strong>API Reference</strong></td><td>Authentication, payments, utilities, transaction enquiries, and webhooks.</td><td><a href="broken://pages/xGbFTpeLuPcUNyn3vkVt">Broken link</a></td></tr><tr><td><h3><i class="fa-scale-balanced" style="color:$primary;">:scale-balanced:</i></h3></td><td><strong>Security &#x26; Compliance</strong></td><td>Secure API access, AML/KYC considerations, data protection, and regulatory guidance.</td><td><a href="/devportal/lypay/regulatory-guidelines-and-compliance.md">Regulatory Guidelines &amp; Compliance</a></td></tr><tr><td><h3><i class="fa-qrcode" style="color:$primary;">:qrcode:</i></h3></td><td><strong>QR Payments</strong></td><td>NUMO QR standards, payment flows, payload structures, and ecosystem references.</td><td><a href="/devportal/lypay/numo-qr-code-standards.md">NUMO QR Code Standards</a></td></tr></tbody></table>

{% hint style="warning" %}

## Note for fintech providers

At this time, fintech companies cannot integrate directly with CBL financial systems. Integration is available through banks and licensed financial institutions. Direct fintech access would fall under open banking, which is not yet available in Libya.
{% endhint %}

## Quick links

* [LYPay Instant Payment System](/devportal/lypay/lypay-instant-payment-system.md)
* [National Alias Directory](/devportal/national-alias-directory-nad.md)
* [LYPay Technical Overview](/devportal/lypay/lypay-instant-payment-system-technical-overview.md)
* [LYPay API Documentation](/devportal/lypay/api-documentation.md)
* [API Reference](broken://pages/xGbFTpeLuPcUNyn3vkVt)
* [Webhooks](/devportal/lypay/api-documentation/api-v1/webhooks.md)
* [Accounting & Settlement](/devportal/lypay/accounting-and-settlement-in-lypay.md)
* [NUMO QR Code Standards](/devportal/lypay/numo-qr-code-standards.md)
* [Contact & Support](/devportal/contact-and-support.md)