Record manual payments

For manual or non-Lago-native payment methods, you can record payments via the API or UI. You can record partial and full payments. The payment status of an invoice only turns to succeeded once the invoice is fully settled. Every manual payment needs a reference, such as a bank transfer or cheque number, of 40 characters at most.

Dashboard
API

To record a payment:

Navigate to an unpaid invoice;
Click the Record Payment button;
Select the payment date;
Enter the payment reference;
Specify the payment amount (partial or full); and
Confirm to record the payment.

Record a payment dialog with the payment date, reference and amount fields — Record a manual payment

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/payments" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "payment": {
    "invoice_id": "486b147a-02a1-4ccf-8603-f3541fc25e7a",
    "amount_cents": 100,
    "reference": "ref1",
    "paid_at": "2025-02-20"
  }
}'

Introduction

Get started

Events & Usage Components

Pricing & Subscriptions

Quotes & Order Forms

Invoicing

Payments & Cash Collection

AI Agents and MCP

Data & Analytics

Revenue recognition

Resources

Record manual payments