Pular para o conteúdo principal

​
O que é PIX IN?

PIX IN é a funcionalidade que permite receber pagamentos PIX na sua conta Owem. Os clientes pagam via QR Code dinâmico e você recebe o valor em segundos.

Instantâneo

Receba em segundos, 24 horas por dia, 7 dias por semana.

QR Code Dinâmico

Cada cobrança tem seu próprio QR Code com valor e dados únicos.

Copia e Cola

Código EMV para pagamento via apps bancários.

Webhooks

Notificação automática quando o pagamento é confirmado.

​
Como Funciona

1

Gera QR Code

Sua aplicação chama a API para gerar um QR Code dinâmico com valor e descrição.
2

Cliente Paga

O cliente escaneia o QR Code ou usa “copia e cola” no app do banco.
3

Owem Processa

O pagamento é processado instantaneamente pelo sistema PIX.
4

Você Recebe

O valor é creditado na sua conta Owem e um webhook é disparado.

​
Casos de Uso

Caso de UsoDescrição
E-commerceCheckout com PIX no site/app
CobrançasGerar boletos PIX para clientes
DoaçõesReceber doações com valor variável
Vendas presenciaisQR Code na maquininha ou impresso
AssinaturasPagamento recorrente via PIX

​
QR Code Dinâmico

Cada QR Code é único e contém:
CampoDescrição
txIdIdentificador único da transação
amountValor da cobrança
descriptionDescrição (aparece no comprovante)
dueDateData de expiração
emvCódigo para “copia e cola”
externalIdIdentificador externo para correlação
metadataObjeto com dados personalizados

​
Exemplo de QR Code Gerado

{
  "txId": "qr_abc123def456ghi789",
  "amount": 99.9,
  "description": "Pedido #12345",
  "dueDate": "2025-12-31T23:59:59.000Z",
  "emv": "00020101021226580014br.gov.bcb.pix...",
  "externalId": "TX-20260113-QRCODE-001",
  "metadata": {
    "orderId": "12345",
    "customField": "valor_personalizado"
  }
}

​
Ciclo de Vida

PENDING → PAID → SETTLED
    ↓
 EXPIRED
StatusDescrição
pendingQR Code gerado, aguardando pagamento
paidPagamento confirmado
settledValor creditado na conta
expiredQR Code expirou sem pagamento

​
Estornos (Refunds)

Você pode estornar um PIX recebido de volta para o pagador original.
Estornos só são permitidos até 90 dias após o pagamento original.

​
Motivos de Estorno

MotivoDescrição
Solicitação do clienteCliente pediu devolução
Erro operacionalCobrança duplicada ou valor errado
FraudePagamento com cartão fraudado

​
Endpoints Relacionados

Gerar QR Code

POST /v4/i/pix/in/dynamic-qrcode

Consultar QR Code

GET /v4/i/pix/in/dynamic-qrcode/{txId}

Estornar

POST /v4/i/pix/in/refund/{endToEndId}

Consultar Estorno

GET /v4/i/pix/in/refund/{endToEndId}

​
Webhook de Confirmação

Quando um pagamento é confirmado, você recebe: 
{
  "event": "pix_in:qrcode_paid",
  "data": {
    "txId": "qr_abc123def456ghi789",
    "endToEndId": "E37839059202512261234567890abcdef",
    "amount": 99.9,
    "paidAt": "2025-12-26T15:30:45.000Z",
    "payer": {
      "name": "MARIA SILVA",
      "cpfCnpj": "***123456**"
    }
  }
}
Configure webhooks em Configurações → Webhooks no painel Owem.