To complete this guide, you will need the following:

1. Create a Supabase Function

To create a Supabase Edge Function you must run the following command locally:

supabase functions new zbd-receive

This will create a /supabase/functions/zbd-receive folder structure in your project.

2. Write the Edge Function

Use the code below as a starting point for your handler function. You will need to replace the ZBD_API_KEY with your own ZBD Project’s API key.

import { serve } from ""

const ZBD_API_KEY = "b7Ya3s2JZKZcXXX2Dqf8wjKTZZZRuWr8";

const zbdReceive = async (_request: Request): Promise<Response> => {
  const res = await fetch("", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "apikey": `${ZBD_API_KEY}`,
    body: JSON.stringify({
      amount: '100000', // 100 satoshis (100,000 msats) -- ~$0.03
      description: 'Money at internet speed', // What is this payment request for?

  const data = await res.json();

  return new Response(JSON.stringify(data), {
    status: 200,
    headers: {
      "Content-Type": "application/json",


3. Receive payment locally

To run this Supabase Edge Function locally you can spin up your Supabase instance using the following command. You may already have this running at this stage.

supabase functions start

Then you can run the following command to start your serverless function:

supabase functions serve zbd-receive --no-verify-jwt

Note that we add the --no-verify-jwt flag to the command to disable JWT verification. This is because we are not passing a JWT token to the function when we call it. This is not recommended for production use.

Supabase CLI will output a HTTP URL endpoint that you can use to test your function by issuing a POST request to that resource.

4. Deploying to Supabase Edge

After testing it locally, you can deploy your function to Supabase Edge using the following command. You will need to enter your Supabase project ID to deploy.

supabase functions deploy zbd-receive

Once you deploy you will receive a URL that you can use to view that function in production on Supabase’s Web Dashboard:

Supabase Edge Functions dashboard

Opening your browser (or another HTTP client) to the URL provided by Supabase: should return a JSON response with the payment request details.

You can also test this using curl command:


You’re looking for the data.invoice.request property in the JSON response. It starts with lnbc1 and is the payment request anyone in the Bitcoin Lightning Network can use to pay you.

Charges and payment requests are usually shown to users as QR codes that can be scanned by mobile apps (e.g. ZBD). Read Callbacks to understand how to receive updates about your payment asynchronously.

5. Try it yourself

You can now begin receiving instant Bitcoin payments on the edge with Supabase + ZBD!