To complete this guide, you will need the following:

1. Create a Next.js Project

Follow the prompts on the create-next-app CLI to create a new project, and then change into the directory of your project.

yarn create next-app <project-name>
cd <project-name>

2. Write an Edge Function

For this guide we will be making use of the App Router inside of Next.js.

Create a new file in the app/api/send/route.ts that makes a payment to a Lightning Address (e.g. with the following code:

import { NextResponse } from 'next/server';

export const runtime = 'edge';
export const dynamic = 'force-dynamic';

const ZBD_BASE_URL = '';
const ZBD_API_KEY = 'b7YW3s2JzZKGcXjIf5Dqof8wjKT2RuWr8';

export async function GET() {
  const res = await fetch(`${ZBD_BASE_URL}/v0/ln-address/send-payment`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'apikey': `${ZBD_API_KEY}`,
    body: JSON.stringify({
      lnAddress: '', // Who is the recipient of the payment?
      amount: '100000', // 100 satoshis (100,000 msats) -- ~$0.03
      comment: 'Money at internet speed', // What is this payment for?

  if (res.ok) {
    const data = await res.json();
    return NextResponse.json(data);

3. Send payment locally

In order to successfully send payments through the API, you must have an active balance in the ZBD Project you are using. Learn more about depositing funds into a ZBD Project wallet.

If you do not have funds in the ZBD Project you are using, you will receive a 4xx error from the API.

Run function locally:

npx next dev

Opening your browser to the following URL: http://localhost:3000/api/send should return a JSON response with the payment sent message.

You can also test this using curl command:

curl http://localhost:3000/api/send

You’re looking for the status of completed to know that the payment settled successfully.

Payments in the Lightning Network are asynchronous so you may see a response stating the payment is processing. This is expected — use the callbackUrl property to receive updates about your payments.

4. Send payment in production

Deploy your project to Vercel:


Opening your browser to the following URL: should now return this in production.

You can also test this using curl command:


5. Try it yourself

You can now begin sending instant Bitcoin payments on the edge with Vercel + ZBD!