Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.metrifox.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The invoice.created webhook is triggered when a new invoice is created in your Metrifox account. Invoices are generated for subscriptions, orders, and other billable events.

​
When It’s Triggered

This event is sent immediately after an invoice is successfully created, which can happen when:
  • A subscription billing cycle starts (recurring invoice)
  • An order is completed and invoiced
  • An invoice is created manually
  • An invoice is generated through the API

​
Payload Structure

{
  "id": "550e8400-e29b-41d4-a716-446655440007",
  "type": "invoice.created",
  "created_at": 1704067620000,
  "data": {
    "invoice": {
      "id": "e0240d63-d025-4e26-ab3c-75a846fd8b88",
      "title": "Order - OE3Y4",
      "due_at": "2026-02-09T23:59:59.999Z",
      "status": "open",
      "comment": "Invoice created for order OE3Y4",
      "sent_at": "2026-02-09T11:10:05.000Z",
      "metadata": {},
      "is_manual": false,
      "issued_at": "2026-02-09T11:08:31.902Z",
      "source_id": "a4966ab2-e2fb-47d3-b562-c470312a082c",
      "tenant_id": "b1b7b362-5c5c-48a5-9454-94c3c4d3e5b3",
      "created_at": "2026-02-09T11:08:32.051Z",
      "deleted_at": null,
      "updated_at": "2026-02-09T11:08:32.362Z",
      "customer_id": "96a271f5-480d-4d53-b23f-46888da09311",
      "customer_key": "cust_ext_67890",
      "source_type": "Orders::Order",
      "completed_at": "2026-02-09T11:08:45.000Z",
      "currency_code": "USD",
      "overdue_until": "2026-02-12T23:59:59.999Z",
      "invoice_number": "INV042",
      "payment_term_val": 0,
      "payment_term_type": "on_receipt",
      "payment_link_status": "non_applicable",
      "failed_payment_count": 0,
      "payment_intent_result": "requires_action",
      "stripe_payment_link_id": "plink_1Q2w3E4r5T6y7U8i",
      "last_payment_failure_at": "2026-02-09T11:09:30.000Z",
      "payment_link_created_at": "2026-02-09T11:08:50.000Z",
      "stripe_payment_link_url": "https://pay.example.com/plink_1Q2w3E4r5T6y7U8i",
      "last_payment_failure_reason": "insufficient_funds"
    },
    "summary": {
      "id": "1795ffd9-02b5-4db4-9280-47ff2342853e",
      "created_at": "2026-02-09T11:08:32.242Z",
      "invoice_id": "e0240d63-d025-4e26-ab3c-75a846fd8b88",
      "updated_at": "2026-02-09T11:08:32.242Z",
      "total_amount": "1458.0",
      "items_subtotal": "1458.0",
      "total_after_tax": "1458.0",
      "total_discounts": "0.0",
      "total_before_tax": "1458.0",
      "total_extra_fees": "0.0",
      "total_tax_amount": "0.0",
      "total_amount_paid": "0.0",
      "total_adjustment_amount": "0.0",
      "total_outstanding_amount": "1458.0"
    }
  }
}

​
Data Fields

The payload includes invoice details and a summary:

​
data.invoice

  • id: Internal invoice ID
  • title: Invoice title or label
  • due_at: Timestamp when the invoice is due
  • status: Invoice status (e.g., “open”, “paid”, “void”, “draft”)
  • comment: Optional invoice comment or note
  • sent_at: Timestamp when the invoice was sent
  • metadata: Custom metadata object
  • is_manual: Whether the invoice was created manually
  • issued_at: Timestamp when the invoice was issued
  • source_id: Source record ID (e.g., order ID)
  • tenant_id: The tenant ID this invoice belongs to
  • created_at: Timestamp when the invoice was created
  • deleted_at: Deletion timestamp (if deleted)
  • updated_at: Timestamp when the invoice was last updated
  • customer_id: ID of the customer this invoice is for
  • customer_key: Your external customer identifier
  • source_type: Source record type
  • completed_at: Completion timestamp (if completed)
  • currency_code: Currency code (e.g., “USD”, “NGN”)
  • overdue_until: Timestamp until which the invoice is overdue (if applicable)
  • invoice_number: Human-readable invoice number
  • payment_term_val: Payment term value
  • payment_term_type: Payment term type (e.g., “on_receipt”)
  • payment_link_status: Payment link status
  • failed_payment_count: Number of failed payment attempts
  • payment_intent_result: Payment intent result (if any)
  • stripe_payment_link_id: Stripe payment link ID (if any)
  • last_payment_failure_at: Timestamp of the last payment failure (if any)
  • payment_link_created_at: Timestamp when payment link was created (if any)
  • stripe_payment_link_url: Stripe payment link URL (if any)
  • last_payment_failure_reason: Reason for last payment failure (if any)

​
data.summary

  • id: Summary ID
  • created_at: Timestamp when the summary was created
  • invoice_id: Invoice ID the summary belongs to
  • updated_at: Timestamp when the summary was last updated
  • total_amount: Total invoice amount
  • items_subtotal: Subtotal of line items
  • total_after_tax: Total after tax
  • total_discounts: Total discounts
  • total_before_tax: Total before tax
  • total_extra_fees: Total extra fees
  • total_tax_amount: Total tax amount
  • total_amount_paid: Total amount paid
  • total_adjustment_amount: Total adjustments
  • total_outstanding_amount: Total outstanding amount

​
Example Use Cases

  • Send invoice emails to customers
  • Sync invoices to your accounting system
  • Update financial records
  • Trigger payment processing workflows
  • Track revenue and billing analytics
  • Generate invoice PDFs