账户控制（可选启用）
本页介绍三个按账户、默认关闭的可选控制，用于在 PIX 收款和付款中加强证件（CPF/CNPJ）校验。它们用于特定的合规/反欺诈场景。
可选启用 - 默认无影响
本页所有控制默认关闭。除非账户持有人明确启用，否则不会影响任何现有集成。 控制关闭时，相关的请求字段会被接受并存储，但不会改变处理逻辑。要启用某项控制或管理授权 CNPJ 清单，请联系您的账户团队。
概述
| 控制 | 方向 | 相关请求字段 | 启用时的效果 |
|---|---|---|---|
| 预期付款方校验 | PIX-IN（收款） | expected_payer_document（cash-in） | 付款方证件与预期不符的收款会被拒绝并退回付款方 |
| 阻止来自 CNPJ 的收款 | PIX-IN | - （无请求字段） | 来自 CNPJ 付款方的收款会被拒绝并退回付款方 |
| 阻止向 CNPJ 发送 | PIX-OUT（付款） | recipient_document（cash-out） | 向 CNPJ 的付款会被阻止，账户授权清单中的 CNPJ 除外 |
预期付款方校验（PIX-IN）
通过 PIX Cash-In 中的可选字段 expected_payer_document 将一笔收款绑定到预期付款方。
- 控制启用： 该收款的付款方证件不匹配（或缺失）时，收款会被拒绝并退回付款方（BACEN/退款），而不是入账。
- 控制关闭（默认）：
expected_payer_document仅被存储，没有阻止效果。 - 字段省略： 无任何变化。
阻止来自 CNPJ 的收款（PIX-IN）
不需要任何新的请求字段。启用时，付款方为 CNPJ 的收款会被拒绝并退回付款方，而不是入账。关闭时（默认），所有收款正常处理。
阻止向 CNPJ 发送（PIX-OUT）
加强 PIX Cash-Out 按密钥 和 PIX Cash-Out 复制粘贴码 中的可选字段 recipient_document。
在付款账户上启用时：
- 付款必须有可确定的收款方证件。如果
pix_key本身就是 CPF/CNPJ，则该密钥具有权威性。否则（随机/EVP 密钥、电话或电子邮件），您必须发送recipient_document。 - 无法确定有效的收款方证件 → 以
cnpj_out_document_required拒绝。 - 收款方 CNPJ 不在账户授权 CNPJ 清单中 → 以
cnpj_out_blocked拒绝。 - 收款方为 CPF，或 CNPJ 在授权清单中 → 允许。
关闭时（默认），recipient_document 被忽略，无任何变化。
授权 CNPJ 清单
授权 CNPJ 清单由您的账户团队管理。当"阻止向 CNPJ 发送"控制启用时，只有该清单中的 CNPJ 才能收到 PIX。
对交易生命周期的影响
当收款被上述任一控制阻止时，它会被拒绝并退回付款方（BACEN 退款），而不是入账。这可通过交易状态和相应的 webhook 查看。参见 PIX Lifecycle 和 按 ID 查询 Cash-In。
错误代码（PIX-OUT）
代码（errors[0].code） | HTTP | 含义 |
|---|---|---|
cnpj_out_document_required | 400/422 | 控制启用且无法确定收款方证件（随机/EVP/电话/电子邮件密钥且未发送 recipient_document） |
cnpj_out_blocked | 400/422 | 控制启用且收款方是不在账户授权 CNPJ 清单中的 CNPJ |