PayZu PixTransferência entre contas

Transferir para outra conta PayZu

POST/internal-transfer

Confira o passo a passo → https://docs.payzu.com.br/docs/pix/transfer-between-accounts


A transferência é liquidada na própria chamada, sem passar pelo Pix.

Body Params

payerAccountNumberstringobrigatório
Sua conta PayZu, de onde sai o valor.
receiverAccountNumberstringobrigatório
Conta PayZu de destino.
amountnumberobrigatório
Valor da transferência.
descriptionstring
Descrição da transferência.
callbackUrlstring
URL que recebe os avisos da transação.
clientReferencestring
Seu identificador. Se repetir, retorna a transferência já criada.
virtualAccountstring
Subconta para separar lojas ou filiais.

Headers

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

Responses

200Transferência concluída
idstringIdentificador da transação na PayZu.
statusstringStatus da transação.
PENDINGCOMPLETEDCANCELEDWAITING_FOR_REFUNDREFUNDEDEXPIREDERROR
amountnumberValor em reais, antes da tarifa.
typestringTipo da transação.
DEPOSITWITHDRAWCOMMISSIONLIQUIDATIONADJUSTMENT
qrCodeTextstring | nullCódigo Pix copia e cola.
qrCodeBase64string | nullImagem PNG do QR Code em base64, sem prefixo.
qrCodeUrlstring | nullRota autenticada que retorna o PNG do QR Code.
generatedNamestring | nullNome usado na cobrança.
generatedDocumentstring | nullCPF ou CNPJ usado na cobrança.
generatedEmailstring | nullE-mail usado na cobrança.
payerNamestring | nullTitular da conta que pagou.
payerDocumentstring | nullCPF ou CNPJ de quem pagou.
payerInstitutionIspbstring | nullISPB da instituição de origem.
payerInstitutionNamestring | nullInstituição de origem do Pix.
payerAccountNumberstring | nullConta PayZu do pagador.
serviceFeeChargednumber | nullTarifa PayZu, que pode ter mais de 2 casas decimais.
withdrawPixKeystring | nullChave de destino do saque, normalizada.
withdrawPixTypestring | nullTipo da chave de destino (evp é a chave aleatória).
cpfcnpjemailphoneevp
receiverNamestring | nullTitular da conta que recebe.
receiverDocumentstring | nullCPF ou CNPJ de quem recebe.
receiverInstitutionIspbstring | nullISPB da instituição de destino.
receiverInstitutionNamestring | nullInstituição de destino do Pix.
receiverAccountNumberstring | nullConta PayZu do recebedor.
endToEndIdstring | nullID end-to-end do Pix.
createdAtstringData e hora do registro.
updatedAtstringData e hora da última alteração.
paidAtstring | nullData e hora da liquidação.
clientReferencestring | nullSeu identificador, enviado na criação.
refundEndToEndIdstring | nullID end-to-end da devolução.
refundAmountnumber | nullValor devolvido.
refundStatusstring | nullStatus da devolução.
PENDINGCOMPLETEDCANCELED
refundReasonstring | nullMotivo: seu pedido, MED, depósito de CNPJ recusado ou ação da PayZu.
CUSTOMER_REQUESTINFRACTIONDENY_COMPANY_DEPOSITADMIN_REQUEST
refundDescriptionstring | nullDescrição da devolução.
refundedAtstring | nullData e hora da devolução.
cancellationReasonstring | nullMotivo do cancelamento.
virtualAccountstring | nullSubconta informada na criação.
methodstringMeio de pagamento.
PIXINTERNAL_TRANSFERBANK_SLIPTED
400Requisição inválida
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsarray of objectsErros de validação por campo.
Campos de cada item 2
fieldstringCampo rejeitado.
messagestringMotivo da rejeição.
401Token ausente ou inválido
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
403Acesso negado
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
409Transferência duplicada
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
422Transferência recusada
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
429Limite de requisições atingido
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
retryAfterSecondsintegerSegundos de espera antes de tentar de novo.

Linguagem

Credenciais Bearer

Token de API

Gerar credencial de sandbox

curl --request POST \     --url https://pix.sandbox.payzu.dev/v1/internal-transfer \     --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