Skip to main content
POST
/
v4
/
i
/
baas
/
pix
/
pay-key
curl -X POST https://api.owem.com.br/v4/i/baas/pix/pay-key \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "123456789012",
    "pixKey": "[email protected]",
    "amount": 50.99,
    "description": "Pagamento teste",
    "externalId": "319c994c-6f36-4315-b5dd-83281f2fa9f2"
  }'

{
  "requestId": "k251m8n6-0o75-445n-8onk-43p895nl8ko4",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "status": "processing",
    "endToEndId": "E5470000120260113987654321098765",
    "amount": 50.99,
    "externalId": "319c994c-6f36-4315-b5dd-83281f2fa9f2",
    "createdAt": 1768265100000
  }
}

curl -X POST https://api.owem.com.br/v4/i/baas/pix/pay-key \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "123456789012",
    "pixKey": "[email protected]",
    "amount": 50.99,
    "description": "Pagamento teste",
    "externalId": "319c994c-6f36-4315-b5dd-83281f2fa9f2"
  }'

​
Descrição

Efetua um pagamento PIX diretamente para uma chave PIX, sem necessidade de QR Code. Suporta todos os tipos de chave: CPF, CNPJ, Email, Telefone e EVP.
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

​
Body

{
  "accountId": "123456789012",
  "pixKey": "[email protected]",
  "amount": 50.99,
  "description": "Pagamento teste",
  "externalId": "319c994c-6f36-4315-b5dd-83281f2fa9f2"
}
CampoTipoObrigatórioDescrição
accountIdstring✅ID da conta que fará o pagamento
pixKeystring✅Chave PIX do destinatário
amountnumber✅Valor do pagamento
descriptionstring❌Descrição do pagamento (max 140 chars)
externalIdstring✅ID externo para rastreamento (UUID)

​
Formatos de Chave PIX

TipoFormatoExemplo
CPF11 dígitos (apenas números)12345678900
CNPJ14 dígitos (apenas números)12345678000199
EMAILEmail válido[email protected]
PHONE+55 + DDD + número (E.164)+5511999998888
EVPUUID (chave aleatória)a1b2c3d4-e5f6-7890-abcd-ef1234567890

​
Response

​
Sucesso (200 OK)

{
  "requestId": "k251m8n6-0o75-445n-8onk-43p895nl8ko4",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "status": "processing",
    "endToEndId": "E5470000120260113987654321098765",
    "amount": 50.99,
    "externalId": "319c994c-6f36-4315-b5dd-83281f2fa9f2",
    "createdAt": 1768265100000
  }
}

​
Campos da Response

CampoTipoDescrição
successbooleanSe a requisição foi aceita
statusstringStatus inicial: processing
endToEndIdstringID E2E do PIX (use para consultar status)
amountnumberValor do pagamento
externalIdstringID externo informado (se enviado)
createdAtnumberTimestamp de criação (ms)

​
Status do Pagamento

StatusDescrição
processingPagamento em processamento
succeededPagamento concluído com sucesso
failedPagamento falhou
O pagamento é assíncrono. Use o endpoint Consultar Pagamento com o endToEndId para verificar o status final.

​
Erros

CódigoDescrição
400Chave PIX inválida ou não encontrada
400Valor deve ser maior que zero
400Saldo insuficiente
403Conta não pertence a este parceiro
404Conta não encontrada

​
Fluxo do Pagamento

Use o campo externalId para identificar o pagamento no seu sistema. Isso facilita a conciliação e rastreamento.
{
  "requestId": "k251m8n6-0o75-445n-8onk-43p895nl8ko4",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "status": "processing",
    "endToEndId": "E5470000120260113987654321098765",
    "amount": 50.99,
    "externalId": "319c994c-6f36-4315-b5dd-83281f2fa9f2",
    "createdAt": 1768265100000
  }
}