PayZu CellCarteira

Consultar o saldo da carteira

GET/v1/wallet

Confira o passo a passo → https://docs.payzu.com.br/docs/cell/wallet-balance


Headers

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

Responses

200Saldo da carteira
environmentstringAmbiente da chave; cada ambiente tem a sua carteira.
LIVETEST
balancenumberSaldo disponível agora, em reais; 0 antes do primeiro crédito.
debitBlockedbooleantrue quando uma recarga foi estornada pelo provedor de pagamento. Até o atendimento do PayZu Cell liberar, o saldo não paga cobranças nem aceita recarga nova.
topUpLimitsobjectLimites de recarga em vigor.
Campos do objeto 3
minAmountnumberMenor valor de uma recarga.
maxAmountnumberMaior valor de uma recarga.
balanceCapnumberSaldo máximo da carteira. Na criação, a recarga que levaria o saldo disponível acima dele é recusada; o Pix já pago sempre entra no saldo.
401Chave ausente ou inválida
statusCodeintegerO mesmo status HTTP da resposta.
errorstringNome do status HTTP em inglês.
messagestringExplicação do erro para quem lê. Decida pelo código: a mensagem pode mudar.
codestringCódigo estável do erro, no formato PZCnnn.
403Acesso negado
statusCodeintegerO mesmo status HTTP da resposta.
errorstringNome do status HTTP em inglês.
messagestringExplicação do erro para quem lê. Decida pelo código: a mensagem pode mudar.
codestringCódigo estável do erro, no formato PZCnnn.
404Não encontrado
statusCodeintegerO mesmo status HTTP da resposta.
errorstringNome do status HTTP em inglês.
messagestringExplicação do erro para quem lê. Decida pelo código: a mensagem pode mudar.
codestringCódigo estável do erro, no formato PZCnnn.
429Limite de requisições atingido
statusCodeintegerO mesmo status HTTP da resposta.
errorstringNome do status HTTP em inglês.
messagestringExplicação do erro para quem lê. Decida pelo código: a mensagem pode mudar.
codestringCódigo estável do erro, no formato PZCnnn.
503Serviço indisponível
statusCodeintegerO mesmo status HTTP da resposta.
errorstringNome do status HTTP em inglês.
messagestringExplicação do erro para quem lê. Decida pelo código: a mensagem pode mudar.
codestringCódigo estável do erro, no formato PZCnnn.
requestIdstringID da requisição, só nos erros 5xx.

Linguagem

Credenciais Bearer

Token de API

curl --request GET \     --url https://api.payzucell.com.br/v1/wallet \     --header 'authorization: Bearer SEU_TOKEN' \     --header 'accept: application/json'
Resposta

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

application/json