PayZu Conta HubConta
Criar uma chave Pix
Registre uma chave nova para a conta, aleatória ou com o documento do titular.
Crie a chave
Envie type. Em EVP, o banco gera a chave e key não deve ser enviado. Nos outros tipos, key é obrigatório, como na tabela de Chaves Pix.
bash
curl --request POST \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/pix-keys' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--data '{ "type": "EVP" }'json
{
"id": "cmu5k2x0a000301s6ab12cd34",
"key": "b3c7e9a2-4f1d-4c8a-9e2b-7d5f6a8c1e03",
"type": "EVP",
"isDefault": true,
"createdAt": "2026-09-17T14:32:05.123Z",
"updatedAt": "2026-09-17T14:32:05.123Z",
"account": {
"bank": { "name": "Banco Exemplo S.A.", "ispb": "99999999" },
"branch": "0001",
"number": "12345678"
}
}Referência: Criar uma chave Pix
Para uma chave de CNPJ, o corpo leva o documento em key.
json
{ "type": "CNPJ", "key": "12345678000195" }Para uma chave de CPF, a regra é a mesma, mas depende do banco parceiro da conta. Quando ele não cria a chave, a resposta é PIX_KEY_TYPE_NOT_SUPPORTED_BY_PROVIDER (422).
A primeira chave da conta nasce padrão.
Para trocar depois, use Definir a chave padrão.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PIX_KEY_DOCUMENT_NOT_HOLDER | 400 | A chave de CPF ou CNPJ precisa ser o documento do titular da conta. |
PIX_KEY_RANDOM_KEY_NOT_ALLOWED | 400 | Chave aleatória é gerada automaticamente e não pode ser informada. |
PIX_KEY_REQUIRED | 400 | Chave é obrigatória para tipos diferentes de EVP. |
PIX_KEY_DUPLICATED | 409 | Esta chave já está cadastrada na conta. |
PIX_KEY_PROVIDER_REFUSED | 422 | A chave PIX foi recusada. |
PIX_KEY_TYPE_NOT_SUPPORTED_BY_PROVIDER | 422 | Não é possível criar chave PIX deste tipo nesta conta. |
Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.