Thanks to our contributor for this guide, Santos Hernandez.


The purpose of this workshop is to help you get your own custom static charge and Lightning Address for your own domain, using Python, Django, and ZBD API.


This write-up is for a hobbyist or beyond developer who wants their own custom QR code and Lightning Address.

What this unlocks

Custom Lightning Address App Screenshot

Custom Lightning Address App Screenshot

You’ll get this awesome landing page. You’ll create a Static Charge QR code to receive money to as well as an internet identifier called Lightning Address to receive money to.


You would need the following:

  • Access to the ZBD API.
    • If you don’t have an account, register an account at here.
  • A basic understanding of programming.

Static Charge & Lightning Address Explained

Use Cases

Static Charges and Lightning Addresses are excellent for easily receiving payments. Static Charges can be set such that they can be used an unlimited number of times and they don’t expire. So it makes receiving payments easy.

You can get your own Lightning Address and Static Charge that is tied to your own username and domain.

How do Static Charges work?

A Static Charge is actually a URL that is used to process incoming payment requests by returning an invoice to the app requesting to make a payment for a specific amount. The app will then take the invoice and pay it.

Static Charge

Example of Static Charge

Lightning Address Explained - it looks like an example but it’s used to receive money to. It could also be an email at the same time. Whoa~.

Return Lightning Address metadata using Django

In this tutorial we’ll setup a Django project that allows you to receive payment to your own lightning address.


Getting started

Install Python

If you already have python installed, skip this section.

You can download and install python here. Select your relevant operating system and install.

Install VS Code

If you already have a code editor installed, skip this section.

This application is a Code Editor that will make it much easier to manage your code. Install it here.

To get started quickly, you can clone the repository where most things are already setup.

Installing Requirements

In your terminal in VS Code, clone the following repository by running this command:

git clone

Next, install the requirements by running the following command:

cd lightning-address-app && pip install -r requirements.txt

If you get an error try running:

pip3 install -r requirements.txt

Plug and Play

Now that you have the codebase setup and the requirements installed, let’s connect your Dev Dashboard account.

Create a .env file with the following config.


We will be updating this throughout the tutorial.

Creating a Static Charge

The ZBD API makes static charge creation very easy. Here is a high-level example of the URL, payload, and the response from the API.

Using the ZBD Doc Portal, send a POST Request to the following URL with the payload beneath it after plugging in your API key.

⭐ Be sure to determine what you want your lightning address to be and update it in the the identifier field. Mine will be

Navigate to the Doc Portal. Add this to your payload AFTER changing the identifier , description , identifier, and succesMessage.

Screenshot 1

  "identifier": "",
  "description": "This is my Static Charge and Lightning Address.",
  "successMessage": "Thank you for supporting me!",
  "allowedSlots": null,
  "minAmount": "1000",
  "maxAmount": "100000000"

Input the data in the applicable parameter fields.


Screenshot 2

Grab your Project’s apikey from the ZBD Dev Dashboard.

Screenshot 3

Add your apikey in the Header in the API Reference.

Screenshot 4

You should get a response that looks something like this.

  "message": "Successfully created Static Charge.",
  "data": {
    "id": "d94e7893-5a1a-4ef9-b2c2-e549fc6b1e0e",
    "unit": "msats",
    "slots": 0,
    "minAmount": "10000",
    "maxAmount": "100000000",
    "identifier": "",
    "createdAt": "2023-05-14T20:55:36.259Z",
    "expiresAt": null,
    "internalId": null,
    "description": "This is my Static Charge and Lightning Address.",
    "callbackUrl": null,
    "allowedSlots": null,
    "successMessage": "Thank you for supporting me!",
    "status": "active",
    "invoice": {
      "request": "lnurl1dp68gurn8ghj7ctsdyh85etzv4jx2efwd9hj7a3s9aex2ut4v4ehgttnw3shg6tr943ksctjvajhxtmy8y6x2dec8yej6dtpx9sj6dr9vcuj6c3jvvez6ef4xsukvcekvgck2vr9ppvamy",
      "uri": "lightning:lnurl1dp68gurn8ghj7ctsdyh85etzv4jx2efwd9hj7a3s9aex2ut4v4ehgttnw3shg6tr943ksctjvajhxtmy8y6x2dec8yej6dtpx9sj6dr9vcuj6c3jvvez6ef4xsukvcekvgck2vr9ppvamy"

After sending your POST request, you should receive the following back as a response. You’ll want to save the id that you get back. We’ll use this to support your own Lightning Address.

You can also save the data.invoice.uri field so that you can turn it into a QR code.


Now each time that you receive payments to your Lightning Address, your ZBD project will get balance increases.

Update your .env file with the ID and the URI.

Creating a Secret Key for Django

Run the following command in your terminal.

python -c 'from import get_random_secret_key; print(get_random_secret_key())'

Copy the output and update your .env file with the output for SECRET_KEY.

Deploying your app to Namecheap

If you don’t have a domain and hosting already, you can sign-up for one at Once you have a domain and hosting, you can proceed.

Note: I am going to assume that you have purchased your domain and have cPanel hosting.

Update your .env file with your own domain. It must be without http, https, or www. For example, my domain is therefore I use that.

Create Python App

Log into your cPanel account. Search for or select Setup Python App .

Screenshot 5

Click Create Application

Screenshot 6

Setup the configuration as follows.

Screenshot 7

Select Python Version: 3.8.16 .

Select Application URL: This is the domain you wish to use for your lightning address. Mine is .

Setup application startup file:

Application Entry point: application

This is what it looks like filled out:

Screenshot 8

Screenshot 9

Connecting via FTP to Upload your App

Download FileZilla here, which is a File Transfer Protocol client. If you already have an FTP client. Please feel to proceed.

Once you have an FTP client such as FileZilla, you’ll want to connect your hosting provider.

Update your Host by entering

For your username, enter your namecheap cpanel username.

  • Enter the password associated with your cpanel account.

Hit quick connect.

Screenshot 10

Once you’ve done that, look for your domain name and double click the folder. Now you’ll want to copy the files in lightning-address-app folder and drop them into the folder.

Screenshot 11

Screenshot 12

You may see this, if you do, please overwrite the file.

Screenshot 13

Wait for it to finish uploading everything and then once it’s done let’s install the requirements.

Install Requirements & Restart the app

Copy the command from your Python App from cPanel.

Screenshot 14

In a new tab, navigate to the terminal app.

Screenshot 15

Paste in the command and hit enter.

Screenshot 16

Type pip3 install -r requirements.txt .

Screenshot 17

Once it is done, go back to your Setup a Python app , hit the edit button, and then restart your Python app.

Screenshot 18

Try it out!

Try sending yourself a payment with the lightning address you just setup 🙂. Payments will fly directly into your associated Project Wallet. LFG 🚀.


You now have your own custom Static Charge & Lightning Address powered by ZBD!