PayZu Conta HubTransferências
Transferir para outra conta PayZu
POST/transactions/internal-transfer
Confira o passo a passo → https://docs.payzu.com.br/docs/account-hub/transfer-between-accounts
Requisições recentes
Body Params
amountintegerobrigatório
Valor que chega ao destino, em centavos.
destinationAccountobjectobrigatório
Agência e número da outra conta PayZu.
commentstring
Texto que aparece no comprovante.
callbackUrlstring
URL que recebe os avisos da transação.
Headers
Authorizationstringobrigatório
Bearer seguido do token de API.
Idempotency-Keystring
Chave única da operação, para repetir sem duplicar.
acceptstring
Formato da resposta.
Responses
201Transferência criada
idstringID da transferência.
statusstringStatus da transferência.
REQUESTEDCONFIRMEDFAILEDsidestringIndica se a sua conta enviou ou recebeu.
SENTRECEIVEDamountintegerValor que chega ao destino, em centavos.
serviceFeeintegerTarifa em centavos; 0 para quem recebe.
totalDebitedintegerTotal com a tarifa, em centavos; 0 para quem recebe.
counterpartyobjectA outra conta da transferência.
Campos do objeto 4
namestringNome da outra conta.
documentstringCPF ou CNPJ da outra conta, com o CPF mascarado.
bankobject | nullInstituição da outra conta.
Campos do objeto 2
namestring | nullNome da instituição.
ispbstring | nullISPB da instituição, com 8 dígitos.
accountobjectAgência e número da outra conta.
Campos do objeto 2
branchstring | nullAgência da conta.
numberstring | nullNúmero da conta, completo.
commentstring | nullTexto que aparece no comprovante.
failureReasonstring | nullMotivo da recusa do banco, para exibir.
callbackUrlstring | nullURL que recebe os avisos da transação.
createdAtstringData e hora do registro.
confirmedAtstring | nullData e hora da conclusão.
failedAtstring | nullData e hora da falha.
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.
404Conta de destino não encontrada
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
409Idempotency-Key já usada
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.
detailsobjectContexto do erro, como valores e limites.
422Transferência recusada
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
detailsobjectContexto do erro, como valores e limites.
429Limite de requisições atingido
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.
503Serviço indisponível
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
Esta página ajudou?