Invoices

Send an invoice

POST/api/v1/invoices/{invoiceID}/send

Email a draft or unpaid invoice to its customer

AuthorizationBearer sk_test_… or sk_live_…

Path parameters#

invoiceIDuuidRequired

Responses#

200OK
401The secret key is missing, invalid or revoked.
403The key is not allowed to do this, or the request came from an address that is not on its allowlist.
404Nothing was found for this business and mode.
409The request clashes with the current state, such as a reference reused with different details.

curl -X POST "https://api.vervapay.com/api/v1/invoices/6f1c2a52-5d0b-4f7e-9a51-3c7c2f0d8e11/send" \
  -H "Authorization: Bearer $FASTPAY_SECRET_KEY"

200OK

{
  "data": {
    "email": "sent",
    "invoice": {
      "created_at": "2026-10-28T09:00:00Z",
      "currency": "NGN",
      "customer_email": "ada@example.com",
      "discount_minor": 0,
      "id": "6f1c2a52-5d0b-4f7e-9a51-3c7c2f0d8e11",
      "items": [
        {
          "description": "Order 1001",
          "quantity": 3,
          "unit_price_minor": 500000
        }
      ],
      "kind": "simple",
      "mode": "test",
      "number": "INV-0001",
      "state": "draft",
      "status": "draft",
      "subtotal_minor": 1500000,
      "tax_bps": 0,
      "tax_minor": 0,
      "total_minor": 1500000,
      "url": "https://fastpay.ng/i/…",
      "customer_id": "0b8c3d3e-6c1a-4b36-8d5e-2a9d1f4c7e02"
    }
  }
}