> 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

#### <sub>Fintech & E-Commerce Access</sub>

Integration with CBL financial systems is currently available through banks and licensed financial institutions.

Participation by fintech companies and e-commerce service providers is planned through the upcoming E-Commerce system, subject to CBL approval and the applicable regulatory, security, technical, and compliance requirements.

**Eligibility criteria, applicable regulations, and integration requirements will be published soon on the CBL Developer Portal.**
{% 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)