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" }'

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ódigoHTTPMensagem
PIX_KEY_DOCUMENT_NOT_HOLDER400A chave de CPF ou CNPJ precisa ser o documento do titular da conta.
PIX_KEY_RANDOM_KEY_NOT_ALLOWED400Chave aleatória é gerada automaticamente e não pode ser informada.
PIX_KEY_REQUIRED400Chave é obrigatória para tipos diferentes de EVP.
PIX_KEY_DUPLICATED409Esta chave já está cadastrada na conta.
PIX_KEY_PROVIDER_REFUSED422A chave PIX foi recusada.
PIX_KEY_TYPE_NOT_SUPPORTED_BY_PROVIDER422Nã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.