Transferência interna

Mova saldo entre duas contas PayZu na hora, sem sair pela rede do Pix, ideal pra repasses entre matriz e filial ou pra pagar parceiros que também são PayZu.

POSTPOST /internal-transfer/internal-transfer GETGET /internal-transfer/internal-transfer Idempotência Webhooks

Quando usar

Repasse entre contas da mesma operação (matriz/filial)
Pagamento a parceiro que também é cliente PayZu
Movimentação interna de saldo (carteiras, sub-contas operacionais)

Criar transferência

Você precisa do accountNumber (6 dígitos) tanto do pagador quanto do recebedor. O pagador deve casar com a conta autenticada pelo token.

curl -X POST https://api.payzu.processamento.com/v1/internal-transfer \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payerAccountNumber": "000000",
    "receiverAccountNumber": "987654",
    "amount": 100.50,
    "description": "Pagamento referente a fatura #1234",
    "callbackUrl": "https://seusite.com.br/webhooks/payzu",
    "clientReference": "transfer-abc-123"
  }'

const res = await fetch('https://api.payzu.processamento.com/v1/internal-transfer', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PAYZU_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    payerAccountNumber: '000000',
    receiverAccountNumber: '987654',
    amount: 100.50,
    description: 'Pagamento referente a fatura #1234',
    callbackUrl: 'https://seusite.com.br/webhooks/payzu',
    clientReference: 'transfer-abc-123',
  }),
});

res = requests.post(
    'https://api.payzu.processamento.com/v1/internal-transfer',
    headers={
        'Authorization': f'Bearer {os.environ["PAYZU_TOKEN"]}',
        'Content-Type': 'application/json',
    },
    json={
        'payerAccountNumber': '000000',
        'receiverAccountNumber': '987654',
        'amount': 100.50,
        'description': 'Pagamento referente a fatura #1234',
        'callbackUrl': 'https://seusite.com.br/webhooks/payzu',
        'clientReference': 'transfer-abc-123',
    },
)

Campos

Campo	Tipo	Obrigatório	Descrição
`payerAccountNumber`	string	Sim	Conta pagadora (6 dígitos). Deve casar com o token.
`receiverAccountNumber`	string	Sim	Conta destino (6 dígitos).
`amount`	number	Sim	Valor em BRL. Mínimo R$ 0,01.
`description`	string	Não	Texto livre de até 500 caracteres.
`callbackUrl`	string	Não	URL para receber atualizações.
`clientReference`	string	Não	Identificador externo (idempotência). Máx 64 chars.
`virtualAccount`	string	Não	Subconta virtual (multi-tenant). Máx 50 chars.

Schema completo em POST /internal-transfer.

Consultar

Aceita id, clientReference ou virtualAccount (use apenas um).

curl "https://api.payzu.processamento.com/v1/internal-transfer?clientReference=transfer-abc-123" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Diferenças vs Pagamento Pix

Aspecto	Transferência interna	Pagamento Pix (`/withdraw`)
Destino	Conta PayZu	Qualquer banco/conta
Tarifa	Conforme tabela da conta	Conforme tabela
Liquidação	Instantânea	Pix em segundos
Identificador	`accountNumber` (6 dígitos)	Chave Pix ou QR Code

O accountNumber da conta destino vem do parceiro PayZu. A plataforma não expõe diretório público de contas.