Pix 密钥类型
Saq 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。
在执行提现之前,我们建议在 DICT 中查询密钥以 验证其是否存在并确认持有人。请参阅 DICT 查询。
MED (Mecanismo Especial de Devolução)
Procedimento do Bacen para proteger usuários Pix em casos de fraude, golpe ou transações não autorizadas. Quando uma atividade suspeita é identificada, a instituição do pagador abre um processo formal pedindo o estorno do valor.
Glossário
Termos, siglas, status e campos que aparecem na Saq. Se você ficou travado em uma sigla do Bacen ou um campo da API, é aqui. Tudo em PT com o nome original quando relevante.