Invoices - Puplar

Create products, add them to a draft invoice, then finalize to get a payment URL.

Create a product

amount is minor units.

curl -X POST https://api.puplar.com/products \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Website redesign",
    "amount": 25000000,
    "currency": "ngn"
  }'

Create a draft invoice

curl -X POST https://api.puplar.com/invoices \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "64f1a2b3c4d5e6f7a8b9c0d1",
    "currency": "ngn",
    "lines": [{ "product": "64f9b3c4d5e6f7a8b9c0d1e2", "quantity": 1 }]
  }'

Finalize

Locks the invoice and returns a hosted checkout url. Status becomes open.

curl -X POST https://api.puplar.com/invoices/64f1a2b3c4d5e6f7a8b9c0d1/finalize \
  -H "Authorization: Bearer sk_live_your_key"

Email it with POST /invoices/{id}/send. Void an open invoice with POST /invoices/{id}/void. Delete drafts; do not void them. Listen for invoice.finalized, invoice.sent, invoice.paid, and invoice.voided. See Webhooks.

{
  "id": "64f1a2b3c4d5e6f7a8b9c0d1",
  "type": "invoice.paid",
  "timestamp": "2026-07-26T12:00:00.000Z",
  "payload": {
    "id": "64f9b3c4d5e6f7a8b9c0d1e2",
    "number": "INV-00012",
    "status": "paid",
    "livemode": true,
    "customer_id": "64aa11b2c3d4e5f6a7b8c9d0",
    "amount": 25000000,
    "currency": "ngn",
    "lines": [
      {
        "product": "64dd44e5f6a7b8c9d0e1f2a3",
        "name": "Website redesign",
        "quantity": 1,
        "unit_amount": 25000000,
        "amount": 25000000
      }
    ],
    "due_date": null,
    "metadata": {},
    "transaction_id": "64bb22c3d4e5f6a7b8c9d0e1",
    "paid_at": "2026-07-26T12:00:00.000Z"
  }
}