Pular para o conteúdo principal

​
O que é PIX OUT?

PIX OUT é a funcionalidade que permite enviar pagamentos PIX da sua conta Owem para qualquer chave PIX no Brasil. Ideal para pagamentos a fornecedores, cashback, e transferências em geral.

Instantâneo

Transferências em segundos, 24/7.

Qualquer Chave

CPF, CNPJ, e-mail, telefone ou chave aleatória.

Idempotência

Use externalId para evitar transferências duplicadas.

Webhooks

Notificação de sucesso ou falha.

​
Como Funciona

1

Envia Requisição

Sua aplicação chama a API com a chave PIX, valor e descrição.
2

Owem Valida

Validamos saldo, limites e dados do destinatário.
3

PIX Processado

O sistema PIX processa a transferência.
4

Confirmação

Webhook é disparado com status final (sucesso ou falha).

​
Casos de Uso

Caso de UsoDescrição
Pagamentos a fornecedoresPague fornecedores automaticamente
CashbackDevolva parte do valor ao cliente
SaquesPermita que usuários saquem saldo
Folha de pagamentoPague funcionários via PIX
ComissõesPague comissões a afiliados

​
Tipos de Chave PIX

A chave PIX é a forma mais comum de identificar o recebedor. Usando a chave, não é necessário informar dados bancários completos.
TipoDescriçãoValidação (Regex)
CPFCPF do recebedor^[0-9]{11}$
CNPJCNPJ do recebedor^[0-9]{14}$
TelefoneNúmero com código país^\+[1-9][0-9]\d{1,14}$
E-mailEndereço de emailEmail válido
EVPChave aleatória (gerada pelo BACEN)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

​
Exemplos de Chaves Válidas

TipoExemplo
CPF12345678901
CNPJ12345678000190
Telefone+5511999999999
E-mail[email protected]
EVPa1b2c3d4-e5f6-7890-abcd-ef1234567890
Além da chave PIX, também é possível fazer pagamentos via QR Code (Copia e Cola) ou informando os dados bancários do recebedor diretamente.

​
Ciclo de Vida

PROCESSING → SUCCEEDED
         ↓
       FAILED
StatusDescrição
processingTransferência em processamento
succeededTransferência concluída com sucesso
failedTransferência falhou

​
Idempotência

Use externalId para garantir que a mesma transferência não seja executada duas vezes: 
{
  "pixKey": "[email protected]",
  "amount": 150.0,
  "description": "Pagamento fornecedor",
  "externalId": "pag-forn-2025-001"
}
Se você enviar a mesma requisição com o mesmo externalId, a API retornará o resultado da transferência original, sem criar uma nova.

​
Validações

Antes de processar, a API valida:
ValidaçãoErro se falhar
Saldo disponívelINSUFFICIENT_BALANCE
Limite diárioDAILY_LIMIT_EXCEEDED
Chave PIX existePIX_KEY_NOT_FOUND
Destinatário não bloqueadoBLOCKED_RECIPIENT
Horário permitidoTRANSFER_NOT_ALLOWED

​
Limites e Taxas

Limites e taxas variam conforme seu plano. Consulte seu contrato ou o painel Owem.
OperaçãoLimite Padrão
Transferências por minuto60
Valor mínimoR$ 0,01
Valor máximo por transaçãoConforme contrato
Limite diárioConforme contrato

​
Endpoints Relacionados

Enviar PIX

POST /v4/i/bank-accounts/{accountId}/transfer/external

Consultar Transferência

GET /v4/i/bank-accounts/{accountId}/transfer/external/{endToEnd}

​
Webhooks

​
Transferência Concluída

{
  "event": "pix_out:succeeded",
  "data": {
    "endToEndId": "E37839059202512261234567890abcdef",
    "externalId": "pag-forn-2025-001",
    "amount": 150.0,
    "status": "succeeded",
    "completedAt": "2025-12-26T15:30:45.000Z",
    "recipient": {
      "name": "EMPRESA FORNECEDORA LTDA",
      "pixKey": "[email protected]"
    }
  }
}

​
Transferência Falhou

{
  "event": "pix_out:failed",
  "data": {
    "endToEndId": null,
    "externalId": "pag-forn-2025-001",
    "amount": 150.0,
    "status": "failed",
    "failedAt": "2025-12-26T15:30:45.000Z",
    "reason": "PIX_KEY_NOT_FOUND"
  }
}

​
Boas Práticas

Sempre use externalId

Garanta idempotência e evite transferências duplicadas.

Valide a chave antes

Confira o formato da chave PIX antes de enviar.

Implemente webhooks

Não dependa apenas de polling; use webhooks.

Monitore falhas

Acompanhe a taxa de falhas para identificar problemas.