PIX Cash Out Copia e Cola

Realiza uma transferência PIX utilizando o código EMV (copia e cola) extraído de um QR Code PIX.

Endpoint

POST /api/v2/external/pix/cash-out

Headers

Header	Tipo	Obrigatório	Descrição
Authorization	String	Sim	Bearer {access_token}
Content-Type	String	Sim	application/json
hmac	String	Sim	Assinatura HMAC-SHA512 do body (hex)

Request Body

Campo	Tipo	Obrigatório	Descrição
amount	Integer	Sim	Valor em centavos. R$ 100,00 = 10000
emv_code	String	Sim	Código EMV copia e cola do QR Code PIX
description	String	Não	Descrição da transferência (max. 140 caracteres)

Código Copia e Cola

O campo emv_code aceita o código EMV completo copiado de um QR Code PIX. A API extrai automaticamente a chave PIX, os dados do recebedor e o valor original da cobrança a partir do payload EMV.

Valor da transferência

O campo amount deve ser informado mesmo quando o QR Code já contém um valor. A API valida que o valor informado seja compatível com o QR Code (estático ou dinâmico).

Exemplo

curl -X POST https://api.owem.com.br/api/v2/external/pix/cash-out \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "hmac: $HMAC" \
  -d '{
    "amount": 10000,
    "emv_code": "00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d5204000053039865802BR5913NOME RECEBEDOR6008BRASILIA62070503***6304ABCD",
    "description": "Pagamento via QR Code"
  }'

Resposta de Sucesso — 200

{
  "worked": true,
  "transaction_id": "PIXOUT20260309a1b2c3d4e5f6",
  "end_to_end_id": "E37839059202603091530abcdef01",
  "amount": 10000,
  "fee": 0,
  "status": "processing",
  "detail": "PIX enviado para processamento"
}

Campo	Tipo	Descrição
worked	Boolean	true indica que a requisição foi aceita
transaction_id	String	Identificador único da transação
end_to_end_id	String	Identificador End-to-End no SPI/BACEN
amount	Integer	Valor da transferência em centavos
fee	Integer	Tarifa cobrada em centavos
status	String	Status inicial: processing
detail	String	Mensagem descritiva

Resposta de Erro — 400

{
  "worked": false,
  "detail": "Código EMV inválido ou não reconhecido"
}

Resposta de Erro — 422

{
  "worked": false,
  "detail": "Saldo insuficiente"
}

Próximos Passos

Após criar a transferência, acompanhe o status via:

• Consultar por ID
• Consultar por E2E ID
• Consultar por Tag

Ou receba a confirmação automaticamente via Webhook.