---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/notify/invoice/receiptCreated/index.md
description: 凭证创建通知（RECEIPT_CREATED）在正向支付成功、支付凭证生成时触发，通知关联票据与凭证的单据信息及订阅场景下的账单周期信息。
---
# 凭证创建通知

```apidef
endpoint: POST receipt.created
name: 凭证创建通知
summary: 支付凭证创建异步回调
tags: Notify, Invoice, Receipt
```

凭证创建通知（RECEIPT_CREATED）在正向支付成功、支付凭证生成时触发，通知关联票据与凭证的单据信息及订阅场景下的账单周期信息。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| clientId | string | M | 商户号。 |
| accId | string | M | 店铺号。 |
| signType | string | M | 签名类型，MD5。 |
| bizContent | string | M | 业务报文 JSON 字符串。首字段 notifyType 标识事件类型，业务字段均为 camelCase，时间字段为秒级时间戳数字；内容见各事件。 该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ notifyType | string | M | 事件类型，本事件固定为 RECEIPT_CREATED 。 |
| └─ receiptId | string | M | 凭证 ID。 |
| └─ receiptNumber | string | M | 凭证单据号。 |
| └─ 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\":\"RECEIPT_CREATED\",\"receiptId\":\"RCT-2610190650100000010100021522\",\"receiptNumber\":\"RCT-2610191000000101\",\"invoiceId\":\"INV-2610190650100000010600011522\",\"invoiceNumber\":\"INV-2610191000000106\",\"subscriptionId\":\"SUB-2610190650100000436700111522\",\"merchantSubscriptionId\":\"MSUBMVEWA8TU1209\",\"startAt\":1792387820,\"endAt\":1795068620}",
  "sign": "SIGN_VALUE"
}
```