Invoices

Create one in the app#

The app’s invoice creation page is /app/invoices/new. Sign in is required to create an invoice, but not to read these docs.

• Open Invoices in a freelancer or merchant profile and choose New invoice.
• Complete your billing details, add the client and amount, and choose accepted payment options.
• Add line items, a due date or a note when needed. Create the invoice and share its payment link.
• The payer needs a wallet or exchange that can send the exact token on the displayed network. No Forwend account is required.

Follow the payment#

The invoice distinguishes money detected on the network, confirmed payment and settlement into your profile wallet. Partial, late and excess payments need separate handling.

A due date describes when the client owes payment. Checkout expiry controls when a transfer can count toward that payment; they are different fields.

Create from your server#

The published forwend Node package can create, read and list invoices. Keep its API key on your server.

import { Forwend } from "forwend";

const forwend = new Forwend({
  apiKey: process.env.FORWEND_KEY!,
  profileId: process.env.FORWEND_PROFILE_ID!,
  baseUrl: process.env.FORWEND_API_URL!,
});

const invoice = await forwend.invoices.create(
  { amountUsd: "1250.00", metadata: { order_id: "1042" } },
  { idempotencyKey: "order-1042" },
);
const latest = await forwend.invoices.get(invoice.invoiceId);