PayZuPayZu Docs
API 端点Transferência interna

创建内部转账

POST
/internal-transfer

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.payzu.processamento.com/v1/internal-transfer" \  -H "Content-Type: application/json" \  -d '{    "payerAccountNumber": "513579",    "receiverAccountNumber": "987654",    "amount": 100.5  }'
{
  "id": "PAYZU20260506T142500ABC123",
  "status": "COMPLETED",
  "amount": 100.5,
  "type": "WITHDRAW",
  "callbackUrl": null,
  "qrCodeText": null,
  "qrCodeBase64": null,
  "qrCodeUrl": null,
  "generatedName": null,
  "generatedDocument": null,
  "generatedEmail": null,
  "serviceFeeCharged": 0,
  "payerName": "Joao Silva",
  "payerDocument": "12345678901",
  "payerInstitutionIspb": "23066240",
  "payerInstitutionName": "PAYZU IP LTDA.",
  "payerAccountNumber": "513579",
  "withdrawPixKey": null,
  "withdrawPixType": null,
  "receiverName": "Maria Santos",
  "receiverDocument": "98765432109",
  "receiverInstitutionIspb": "23066240",
  "receiverInstitutionName": "PAYZU IP LTDA.",
  "receiverAccountNumber": "987654",
  "endToEndId": null,
  "clientReference": "transfer_abc_123",
  "createdAt": "2026-05-06T14:25:00.000Z",
  "updatedAt": "2026-05-06T14:25:00.123Z",
  "paidAt": "2026-05-06T14:25:00.123Z",
  "refundEndToEndId": null,
  "refundAmount": null,
  "refundStatus": null,
  "refundReason": null,
  "refundDescription": null,
  "refundedAt": null,
  "cancellationReason": null
}
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "querystring/dateFrom Invalid input: expected string, received undefined",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}
{
  "statusCode": 403,
  "error": "Forbidden",
  "message": "Token does not have permission for this operation",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}
{
  "statusCode": 422,
  "error": "Unprocessable Entity",
  "message": "Insufficient balance for this operation",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}

Transferência interna

Move saldo entre duas contas PayZu sem passar pelo Pix tradicional. Liquidação instantânea, identificação por accountNumber. Ideal para repasses matriz/filial, marketplaces e payouts entre clientes PayZu.

Get internal transfer

Retrieve an internal transfer by id or clientReference Use apenas um destes parâmetros: id, clientReference. Combinar mais de um retorna erro.