PayZu CellOperações

Recarregar a carteira por Pix


Nesta páginaCrie a recargaPague o PixConfira o créditoLimites da recargaRepita o pedido sem gerar outro PixErros

Ponha saldo na carteira de produção com um Pix, para pagar as cobranças das suas linhas na hora.

Crie a recarga

Envie o valor e o e-mail de quem paga, que segue com o Pix para o provedor de pagamento. A empresa aparece como pagadora, com o nome e o documento do cadastro.

bash
curl -X POST https://api.payzucell.com.br/v1/wallet/top-ups \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Idempotency-Key: 6f1c2d9e-8a4b-4c3d-9e7f-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{"amount": 500, "email": "financeiro@suaempresa.com.br"}'

Mostre o pixCopyPaste ou o pixQrCode a quem vai pagar.

Referência: Recarregar a carteira por Pix

Pague o Pix

O saldo sobe quando o provedor de pagamento confirma o Pix. O pagamento entra no saldo uma vez, mesmo que chegue depois de expiresAt.

Confira o crédito

Consulte o saldo ou o extrato, em que a recarga aparece com o tipo TOP_UP.

Limites da recarga

Os limites vêm em topUpLimits, no saldo da carteira.

CampoLimite
minAmountMenor valor de uma recarga.
maxAmountMaior valor de uma recarga.
balanceCapSaldo máximo da carteira. Na criação, a recarga que levaria o saldo disponível acima dele é recusada, mas o Pix já pago sempre entra no saldo.

Repita o pedido sem gerar outro Pix

O cabeçalho Idempotency-Key é obrigatório e vale 24 horas em cada ambiente.

Ao repetir a chaveResposta
Com o mesmo corpo, depois de um sucessoA mesma recarga, com o cabeçalho Idempotent-Replayed em true.
Com outro corpo409 com PZC004.
Com o primeiro pedido ainda em andamento409 com PZC201.

A chave de testes não gera Pix.

Por isso, a recarga com a chave de testes é recusada com 422. A carteira de testes recebe o crédito do atendimento do PayZu Cell.

Erros

CódigoHTTPMensagem
PZC001400Corpo ou parâmetro fora do formato.
PZC200409O estado atual da linha não permite esta operação.
PZC300422O provedor de pagamento recusou a operação.
PZC301502O provedor de pagamento não respondeu; consulte o estado antes de repetir.
PZC304422O provedor de pagamento não atende este meio de pagamento.
PZC307422A recarga passaria do saldo máximo da carteira.

Na recarga, o PZC001 também recusa o valor fora dos limites, o PZC200 indica a carteira bloqueada por uma recarga estornada e o PZC304 vem da chave de testes. Depois de um 502, a resposta não traz o id da recarga, e a API não tem consulta da recarga. Guarde o requestId do erro antes de tentar de novo.

Os outros códigos estão no Catálogo de erros.