---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/notify/invoice/finalized/index.md
description: 票据定稿通知（INVOICE_FINALIZED）在票据定稿、单据号分配完成时触发，通知票据 ID、票据单据号及订阅场景下的账单周期信息。
---
# 票据定稿通知

```apidef
endpoint: POST invoice.finalized
name: 票据定稿通知
summary: 票据定稿（单据号分配完成）异步回调
tags: Notify, Invoice
```

票据定稿通知（INVOICE_FINALIZED）在票据定稿、单据号分配完成时触发，通知票据 ID、票据单据号及订阅场景下的账单周期信息。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| clientId | string | M | 商户号。 |
| accId | string | M | 店铺号。 |
| signType | string | M | 签名类型，MD5。 |
| bizContent | string | M | 业务报文 JSON 字符串。首字段 notifyType 标识事件类型，业务字段均为 camelCase，时间字段为秒级时间戳数字；内容见各事件。 该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ notifyType | string | M | 事件类型，本事件固定为 INVOICE_FINALIZED 。 |
| └─ invoiceId | string | M | 票据 ID。 |
| └─ invoiceNumber | string | M | 票据单据号，定稿时分配。 |
| └─ subscriptionId | string | O | PingPong 订阅号。订阅场景返回，非订阅场景不返回。 |
| └─ merchantSubscriptionId | string | O | 商户侧订阅号。订阅场景返回，非订阅场景不返回。 |
| └─ startAt | long | O | 账单所属周期起期，秒级时间戳数字。订阅场景返回。 |
| └─ endAt | long | O | 账单所属周期止期，秒级时间戳数字。订阅场景返回。 |
| sign | string | M | 签名值，沿用 V4 签名规范验签，所有参数均参与签名。 |

### 请求示例

```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"
}
```