Skip to main content
POST
/
v4
/
i
/
bank-accounts
/
{accountId}
/
transfer
/
internal
curl -X POST https://api.owem.com.br/v4/i/bank-accounts/572471114780/transfer/internal \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150.00,
    "receiverBankAccount": "790339033930",
    "obs": "Pagamento de serviço",
    "externalId": "pedido_12345"
  }'

{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "success": true,
  "size": 1,
  "message": "Transferência interna iniciada",
  "data": {
    "id": "I202501081200AbCdEfGhIjKlMnOpQr_OUT",
    "idempotencyKey": "debit:internal:transfer_out:I202501081200AbCdEfGhIjKlMnOpQr_OUT",
    "externalId": "pedido_12345",
    "metadata": {},
    "type": "debit",
    "reason": "internal:transfer_out",
    "status": "succeeded",
    "grossAmount": 150.0,
    "feeAmount": 0,
    "netAmount": 150.0,
    "endToEndId": "I202501081200AbCdEfGhIjKlMnOpQr_OUT",
    "parentEndToEndId": null,
    "entryId": null,
    "requestId": null,
    "pixKey": null,
    "userId": "usr_abc123",
    "accountId": "572471114780",
    "createdAt": 1736337600000,
    "createdDate": "2025-01-08",
    "updatedAt": 1736337600000,
    "updatedDate": "2025-01-08",
    "payer": {
      "ispb": "37839059",
      "personType": "company",
      "cpfCnpj": "12345678000199",
      "name": "EMPRESA ORIGEM LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "572471114780"
    },
    "receiver": {
      "ispb": "37839059",
      "personType": "company",
      "cpfCnpj": "98765432000111",
      "name": "EMPRESA DESTINO LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "790339033930"
    },
    "medId": null,
    "medCreatedAt": null,
    "medCreatedDate": null,
    "refundedEndToEndId": null,
    "split": null,
    "af": null,
    "sameDocument": null,
    "obs": "Pagamento de serviço"
  }
}

curl -X POST https://api.owem.com.br/v4/i/bank-accounts/572471114780/transfer/internal \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150.00,
    "receiverBankAccount": "790339033930",
    "obs": "Pagamento de serviço",
    "externalId": "pedido_12345"
  }'

​
Descrição

Realiza transferência instantânea entre duas contas internas da Owem. Diferente do PIX externo, transferências internas são processadas imediatamente.
Esta operação é instantânea. Ambas as contas devem pertencer à infraestrutura da Owem.

​
Autenticação

Este endpoint usa Basic Auth.
Authorization: Basic {Base64(API_KEY:API_SECRET)}

​
Request

​
Headers

HeaderTipoObrigatórioDescrição
Authorizationstring✅Bearer Token ou Basic Auth
Content-Typestring✅application/json

​
Path Parameters

ParâmetroTipoObrigatórioDescrição
accountIdstring✅Número da conta de origem

​
Body

CampoTipoObrigatórioDescrição
amountnumber✅Valor em reais (ex: 100.50)
receiverBankAccountstring✅Número da conta de destino (interna)
obsstring❌Observação/descrição da transferência
externalIdstring❌ID externo para conciliação
{
  "amount": 150.0,
  "receiverBankAccount": "790339033930",
  "obs": "Pagamento de serviço",
  "externalId": "pedido_12345"
}

​
Campos da Response

CampoTipoDescrição
idstringID único da transferência
idempotencyKeystringChave de idempotência
externalIdstringID externo informado na requisição
typestringTipo: debit
reasonstringMotivo: internal:transfer_out
statusstringStatus: succeeded, pending, failed
grossAmountnumberValor bruto transferido
feeAmountnumberTaxa (sempre 0 para internas)
netAmountnumberValor líquido
endToEndIdstringID único da transação
accountIdstringConta de origem
payerobjectDados do pagador
receiverobjectDados do recebedor
obsstringObservação da transferência
createdAtnumberTimestamp de criação (ms)
createdDatestringData de criação (YYYY-MM-DD)

​
Erros

CódigoDescrição
400Dados inválidos ou incompletos
400Valor deve ser maior que zero
400Conta de destino não encontrada
400Conta de destino não é interna
403Sem permissão para esta conta
404Conta de origem não encontrada
422Saldo insuficiente

​
Diferenças: Interna vs Externa

CaracterísticaTransferência InternaPIX Externo
DestinoConta OwemQualquer banco
TaxaConforme contratoConforme contrato
ProcessamentoInstantâneoAté 10 segundos
Horário24/724/7
IdentificaçãoreceiverBankAccountpixKey ou dados bancários
Use transferências internas para movimentação entre suas próprias contas ou entre contas de clientes na sua estrutura BAAS. É mais rápido e sem custo!
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "success": true,
  "size": 1,
  "message": "Transferência interna iniciada",
  "data": {
    "id": "I202501081200AbCdEfGhIjKlMnOpQr_OUT",
    "idempotencyKey": "debit:internal:transfer_out:I202501081200AbCdEfGhIjKlMnOpQr_OUT",
    "externalId": "pedido_12345",
    "metadata": {},
    "type": "debit",
    "reason": "internal:transfer_out",
    "status": "succeeded",
    "grossAmount": 150.0,
    "feeAmount": 0,
    "netAmount": 150.0,
    "endToEndId": "I202501081200AbCdEfGhIjKlMnOpQr_OUT",
    "parentEndToEndId": null,
    "entryId": null,
    "requestId": null,
    "pixKey": null,
    "userId": "usr_abc123",
    "accountId": "572471114780",
    "createdAt": 1736337600000,
    "createdDate": "2025-01-08",
    "updatedAt": 1736337600000,
    "updatedDate": "2025-01-08",
    "payer": {
      "ispb": "37839059",
      "personType": "company",
      "cpfCnpj": "12345678000199",
      "name": "EMPRESA ORIGEM LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "572471114780"
    },
    "receiver": {
      "ispb": "37839059",
      "personType": "company",
      "cpfCnpj": "98765432000111",
      "name": "EMPRESA DESTINO LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "790339033930"
    },
    "medId": null,
    "medCreatedAt": null,
    "medCreatedDate": null,
    "refundedEndToEndId": null,
    "split": null,
    "af": null,
    "sameDocument": null,
    "obs": "Pagamento de serviço"
  }
}