PayZu Conta HubChaves Pix

Criar uma chave Pix

POST/transactions/pix-keys

Confira o passo a passo → https://docs.payzu.com.br/docs/account-hub/create-a-pix-key


Body Params

typestring enumobrigatório
Tipo da chave Pix.EVPCNPJCPFEMAILPHONE
keystring
Valor da chave.

Headers

Authorizationstringobrigatório
Bearer seguido do token de API.
acceptstring
Formato da resposta.

Responses

201Chave criada
idstringID da chave, usado para excluir ou definir a padrão.
keystringValor da chave, completo.
typestringTipo da chave Pix.
EVPCNPJCPFEMAILPHONE
isDefaultbooleanIndica se é a chave padrão da conta.
createdAtstringData e hora do registro.
updatedAtstringData e hora da última alteração.
accountobjectConta onde a chave foi criada.
Campos do objeto 3
bankobjectInstituição da conta.
Campos do objeto 2
namestring | nullNome da instituição.
ispbstring | nullISPB da instituição, com 8 dígitos.
branchstring | nullAgência da conta.
numberstring | nullNúmero da conta, completo.
400Requisição inválida
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
401Credencial ausente ou inválida
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
403Acesso negado
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
409Chave já cadastrada
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
412Pré-requisito pendente
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
422Operação recusada
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
detailsobjectContexto do erro, como valores e limites.
502Falha na instituição financeira
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
detailsobjectContexto do erro, como valores e limites.

Linguagem

Credenciais Bearer

Token de API

curl --request POST \     --url https://api.sandbox.payzu.dev/api/v1/transactions/pix-keys \     --header 'authorization: Bearer SEU_TOKEN' \     --header 'accept: application/json' \     --header 'content-type: application/json' \     --data '{}'
Resposta

Clique em Try It! para enviar uma requisição e ver a resposta aqui. Ou escolha um exemplo:

application/json