v1

latestOpenAPI 3.1.02026-07-24233206489.1 KB

Invoices

Send an invoice

Finalizes a draft to open: mints a hosted checkout session and emails the customer. The optional body's notify: false finalizes without the checkout session or email, for callers that collect payment themselves. A notify send fails with 502 (invoice stays draft) if the checkout session cannot be minted.

post/v1/invoices/{id}/send

Path parameters

idstring required

Invoice ID

Request body

notifyboolean

originstring

Origin identifies the source that triggered the send so the settled payment is attributed to the right payment channel. Defaults to "invoices" when omitted; a caller such as orders-api or subscriptions passes its own source (e.g. "orders"). Must be a value checkout-api-go and core-api allow.

Example request

{
  "notify": true,
  "origin": "invoices"
}

Response

has_moreboolean

Example response

{
  "data": {
    "accent_color": "#0C2F28",
    "amount_due": 145000,
    "checkout_session_id": "cs_abc123",
    "created_at": "2026-07-08 08:00:00+00:00",
    "currency": "PHP",
    "customer_email": "juan@example.com",
    "customer_id": "cus_abc123",
    "customer_name": "Juan dela Cruz",
    "customer_phone": "+639171234567",
    "customer_tin": "123-456-789-000",
    "discount": 5000,
    "due_at": "2026-07-22 00:00:00+00:00",
    "footer_bg_color": "#FFFDF6",
    "footer_image_url": "https://example.com/footer.png",
    "header_bg_color": "#0C2F28",
    "header_image_url": "https://example.com/header.png",
    "hosted_slug": "inv-8f2k1x",
    "hosted_url": "https://invoices.paymongo.com/inv/inv-8f2k1x",
    "id": "si_abc123",
    "internal_notes": "Net-14 terms agreed with the client",
    "issue_at": "2026-07-08 00:00:00+00:00",
    "line_items": [
      {
        "amount": 75000,
        "description": "Website design services",
        "id": "sili_abc123",
        "line_total": 150000,
        "quantity": 2
      }
    ],
    "logo_url": "https://example.com/logo.png",
    "notes": "Thank you for your business!",
    "number": "INV-0001",
    "organization_id": "org_abc123",
    "paid_at": "2026-07-10 08:30:00+00:00",
    "payment_methods": [
      "card",
      "gcash"
    ],
    "reminders_enabled": true,
    "sent_at": "2026-07-08 09:00:00+00:00",
    "subtotal": 150000,
    "total": 145000,
    "updated_at": "2026-07-08 09:00:00+00:00"
  }
}