Skip to main content
POST
/
v4
/
i
/
baas
/
pix
/
{accountId}
/
transfer
/
internal
curl -X POST https://api.owem.com.br/v4/i/baas/pix/123456789012/transfer/internal \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "receiverBankAccount": "987654321098",
    "amount": 100.00,
    "obs": "Pagamento de comissão",
    "externalId": "transfer-001"
  }'

{
  "requestId": "a123b456-c789-d012-e345-f678g901h234",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "status": "succeeded",
    "endToEndId": "E5470000120260115123456789012345",
    "amount": 100.0,
    "externalId": "transfer-001",
    "payer": {
      "name": "EMPRESA ORIGEM LTDA",
      "cpfCnpj": "**.456.789/0001-**"
    },
    "receiver": {
      "name": "EMPRESA DESTINO LTDA",
      "cpfCnpj": "**.654.321/0001-**"
    },
    "createdAt": 1768352400000
  }
}

curl -X POST https://api.owem.com.br/v4/i/baas/pix/123456789012/transfer/internal \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "receiverBankAccount": "987654321098",
    "amount": 100.00,
    "obs": "Pagamento de comissão",
    "externalId": "transfer-001"
  }'

​
Descrição

Realiza uma transferência interna entre duas contas do mesmo parceiro BaaS. Ambas as contas devem pertencer ao seu parceiro.
PROGRAMA BETA - Este endpoint está disponível apenas para parceiros aprovados no programa BAAS.

​
Autenticação

Este endpoint usa Basic Auth com sua API Key + Secret. O scope baas:pix é configurado pela Owem na sua API Key.
Authorization: Basic {Base64(API_KEY:API_SECRET)}

​
Request

​
Headers

HeaderTipoObrigatórioDescrição
Authorizationstring✅Basic Auth (API Key + Secret em Base64)
Content-Typestring✅application/json

​
Path Parameters

ParâmetroTipoObrigatórioDescrição
accountIdstring✅ID da conta de origem (payer)

​
Body

CampoTipoObrigatórioDescrição
receiverBankAccountstring✅ID da conta de destino
amountnumber✅Valor da transferência (> 0)
obsstring❌Observação/descrição
externalIdstring❌ID externo para rastreamento
Exemplo de Body
{
  "receiverBankAccount": "987654321098",
  "amount": 100.0,
  "obs": "Pagamento de comissão",
  "externalId": "transfer-001"
}

​
Response

​
Sucesso (201 Created)

{
  "requestId": "a123b456-c789-d012-e345-f678g901h234",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "status": "succeeded",
    "endToEndId": "E5470000120260115123456789012345",
    "amount": 100.0,
    "externalId": "transfer-001",
    "payer": {
      "name": "EMPRESA ORIGEM LTDA",
      "cpfCnpj": "**.456.789/0001-**"
    },
    "receiver": {
      "name": "EMPRESA DESTINO LTDA",
      "cpfCnpj": "**.654.321/0001-**"
    },
    "createdAt": 1768352400000
  }
}

​
Campos da Response

CampoTipoDescrição
successbooleanSe a transferência foi criada com sucesso
statusstringStatus da transferência (succeeded)
endToEndIdstringID E2E da transferência
amountnumberValor transferido
externalIdstringID externo (se informado)
payerobjectDados do pagador (conta origem)
receiverobjectDados do recebedor (conta destino)
createdAtnumberTimestamp de criação (ms)

​
Erros

CódigoDescrição
400Dados inválidos (amount menor ou igual a 0, etc.)
400Conta de destino não pode ser igual a conta de origem
403Conta não pertence a este parceiro
404Conta de origem ou destino não existe
422Saldo insuficiente na conta de origem
Transferências internas são instantâneas e não possuem taxa. O saldo é debitado e creditado imediatamente.
Use o campo externalId para rastrear a transferência no seu sistema. Você pode consultá-la depois pelo endpoint de consulta de pagamento.
{
  "requestId": "a123b456-c789-d012-e345-f678g901h234",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "status": "succeeded",
    "endToEndId": "E5470000120260115123456789012345",
    "amount": 100.0,
    "externalId": "transfer-001",
    "payer": {
      "name": "EMPRESA ORIGEM LTDA",
      "cpfCnpj": "**.456.789/0001-**"
    },
    "receiver": {
      "name": "EMPRESA DESTINO LTDA",
      "cpfCnpj": "**.654.321/0001-**"
    },
    "createdAt": 1768352400000
  }
}