PayZu PixConta e relatórios
Lista de permissão
Consulte os CNPJs e as chaves Pix que a PayZu autorizou na lista de permissão da sua conta.
| Item da lista | Efeito |
|---|---|
| CNPJ | O Pix de um pagador com esse CNPJ é registrado na sua conta como depósito via chave Pix. |
| Chave Pix | Um Pix que outra conta PayZu envia para essa chave pode ser liquidado direto na sua conta, sem passar pelo Pix. |
A lista de permissão é cadastrada pela PayZu.
Para incluir ou remover um CNPJ ou uma chave Pix, fale com o suporte.
Liste os CNPJs autorizados
bash
curl "https://pix.sandbox.payzu.dev/v1/user/whitelist/cnpj?active=true&limit=20" \
-H "Authorization: Bearer SEU_TOKEN"json
{
"data": [
{
"id": "cmf0w1t3l0001qk08cnpj0001",
"cnpj": "12345678000199",
"description": "Empresa Distribuidora",
"active": true,
"createdAt": "2026-08-08T10:00:00.000Z"
}
],
"pageInfo": {
"hasNextPage": false
}
}Referência: Listar os CNPJs autorizados
- Filtros:
activee o período de cadastro, emfrometo. - Itens por página:
limitvai de 1 a 100; se não for informado, vale 20. - Próxima página: quando
pageInfo.hasNextPagevier verdadeiro, passepageInfo.nextCursoremcursor. Na última página,nextCursornão vem.
Liste as chaves Pix autorizadas
Os filtros e a paginação são os mesmos da lista de CNPJs. Cada item traz a chave em pixKey e o tipo em pixType.
bash
curl "https://pix.sandbox.payzu.dev/v1/user/whitelist/pix-key?active=true&limit=20" \
-H "Authorization: Bearer SEU_TOKEN"json
{
"data": [
{
"id": "cmf0w1t3l0001qk08pixk0001",
"pixKey": "repasse@exemplo.com.br",
"pixType": "email",
"description": "Conta de repasse",
"active": true,
"createdAt": "2026-09-16T12:00:00.000Z"
}
],
"pageInfo": {
"hasNextPage": false
}
}Referência: Listar as chaves Pix autorizadas
Os códigos de erro desta rota são os de autenticação e de validação, que estão no Catálogo de erros.