Pix 密钥类型
央行认可的五种官方密钥类型、每种要求的格式,以及密钥不符合规范时 API 如何在送到央行之前当场拒绝。
PayZu API 接受 Bacen 定义的 5 种官方 Pix 密钥类型。pixType 字段
表示正在使用的类型,pixKey 的格式
根据每种类型而变化。
可用类型
| 类型 | 描述 | 格式 | 示例 |
|---|---|---|---|
cpf | 持有人的 CPF(自然人) | 11 位数字,无格式化 | 12345678901 |
cnpj | 持有人的 CNPJ(法人) | 14 位数字,无格式化 | 12345678901234 |
phone | 手机号码 | E.164 标准格式,含国家代码(55) | 5511987654321 |
email | 电子邮件地址 | 有效的 email 格式 | user@domain.com |
evp | 随机密钥 | UUID v4(由 Bacen 颁发) | 123e4567-e89b-12d3-a456-426655440000 |
验证
API 根据传入的 pixType 自动验证 pixKey 的格式。
如果格式不匹配,将在
向 Bacen 发送操作之前返回 400 Bad Request。
在执行 Pix 付款之前,我们建议在 DICT 中查询密钥以 验证其是否存在并确认持有人。请参阅 DICT 查询。