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


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.
REQUESTEDCONFIRMEDFAILED
sidestringIndica se a sua conta enviou ou recebeu.
SENTRECEIVED
amountintegerValor 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.

Linguagem

Credenciais Bearer

Token de API

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