---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/notify/invoice/finalized/index.md
description: >-
  The Invoice Finalized notification (INVOICE_FINALIZED) is triggered when an
  invoice is finalized and its document number is assigned, carrying the invoice
  ID, invoice number and, in subscription scenarios, the billed period
  information.
---
# Invoice Finalized Notification

```apidef
endpoint: POST invoice.finalized
name: Invoice Finalized Notification
summary: Invoice finalized (document number assigned) async callback
tags: Notify, Invoice
```

The Invoice Finalized notification (INVOICE_FINALIZED) is triggered when an invoice is finalized and its document number is assigned, carrying the invoice ID, invoice number and, in subscription scenarios, the billed period information.

## Request Parameters

| Parameter | Type | Required | Description |
|--------|------|------|------|
| clientId | string | M | Merchant ID. |
| accId | string | M | Store ID. |
| signType | string | M | Signature type, MD5. |
| bizContent | string | M | Business message as a JSON string. The first field, notifyType , identifies the event type. Business fields are camelCase and time fields are second-level timestamp numbers; see each event for details. |
| └─ notifyType | string | M | Event type, fixed as INVOICE_FINALIZED for this event. |
| └─ invoiceId | string | M | Invoice ID. |
| └─ invoiceNumber | string | M | Invoice number, assigned at finalization. |
| └─ subscriptionId | string | O | PingPong subscription ID. Returned for subscription scenarios; absent otherwise. |
| └─ merchantSubscriptionId | string | O | Merchant-side subscription ID. Returned for subscription scenarios; absent otherwise. |
| └─ startAt | long | O | Start of the billing period covered by this invoice, as a second-level timestamp number. Returned for subscription scenarios. |
| └─ endAt | long | O | End of the billing period covered by this invoice, as a second-level timestamp number. Returned for subscription scenarios. |
| sign | string | M | Signature value, verified using the V4 signature specification. All parameters participate in the signature. |

### Request Example

```json
{
  "clientId": "20250101123456",
  "accId": "ACC001",
  "signType": "MD5",
  "bizContent": "{\"notifyType\":\"INVOICE_FINALIZED\",\"invoiceId\":\"INV-2610191028100000011300011522\",\"invoiceNumber\":\"INV-2610191000000113\",\"subscriptionId\":\"SUB-2610191028100000438700111522\",\"merchantSubscriptionId\":\"MSUBMVF42TZK50\",\"startAt\":1792405713,\"endAt\":1795084113}",
  "sign": "SIGN_VALUE"
}
```