Skip to main content
POST
/
v4
/
i
/
bank-accounts
/
{accountId}
/
transfer
/
pay
curl -X POST https://api.owem.com.br/v4/i/bank-accounts/572471114780/transfer/pay \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "emv": "00020126580014BR.GOV.BCB.PIX0136a1b2c3d4-e5f6-7890-abcd-ef123456789052040000530398654041005802BR5913LOJA EXEMPLO6009SAO PAULO62140510ABC12345676304XXXX",
    "amount": 100.00,
    "pixKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "externalId": "pedido_12345"
  }'

{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "success": true,
  "size": 1,
  "data": {
    "metadata": {
      "idempotencyKey": "debit:pix_out:emv_pay:E37839059202501081200ABC123"
    },
    "type": "debit",
    "reason": "pix_out:emv_pay",
    "status": "succeeded",
    "grossAmount": 100.0,
    "feeAmount": 0,
    "netAmount": 100.0,
    "externalId": "pedido_12345",
    "endToEndId": "E37839059202501081200ABC123",
    "parentEndToEndId": null,
    "entryId": null,
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "userId": "usr_abc123def",
    "accountId": "572471114780",
    "createdAt": 1736337600000,
    "createdDate": "2025-01-08",
    "updatedAt": 1736337600000,
    "updatedDate": "2025-01-08",
    "payer": {
      "ispb": "37839059",
      "personType": "company",
      "cpfCnpj": "12345678000199",
      "name": "EMPRESA PAGADORA LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "572471114780"
    },
    "receiver": {
      "ispb": "37839059",
      "personType": "person",
      "cpfCnpj": "12345678900",
      "name": "JOAO DA SILVA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "987654321098"
    },
    "medId": null,
    "medCreatedAt": null,
    "medCreatedDate": null,
    "refundedEndToEndId": null,
    "errorMessage": null,
    "id": "E37839059202501081200ABC123",
    "idempotencyKey": "debit:pix_out:emv_pay:E37839059202501081200ABC123"
  }
}

curl -X POST https://api.owem.com.br/v4/i/bank-accounts/572471114780/transfer/pay \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "emv": "00020126580014BR.GOV.BCB.PIX0136a1b2c3d4-e5f6-7890-abcd-ef123456789052040000530398654041005802BR5913LOJA EXEMPLO6009SAO PAULO62140510ABC12345676304XXXX",
    "amount": 100.00,
    "pixKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "externalId": "pedido_12345"
  }'

​
Descrição

Realiza pagamento PIX através da leitura de um QR Code (EMV). Use este endpoint para pagar cobranças PIX, boletos com QR Code ou qualquer pagamento que utilize o padrão EMV do PIX.
Este endpoint lê o código EMV do QR Code e realiza o pagamento automaticamente para o destinatário codificado.

​
Autenticação

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

​
Request

​
Headers

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

​
Path Parameters

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

​
Body

CampoTipoObrigatórioDescrição
emvstring✅Código EMV do QR Code PIX
amountnumber✅Valor do pagamento em reais
pixKeystring❌Chave PIX do destinatário (para validação)
externalIdstring❌ID externo para conciliação
{
  "emv": "00020126580014BR.GOV.BCB.PIX0136a1b2c3d4-e5f6-7890-abcd-ef123456789052040000530398654041005802BR5913LOJA EXEMPLO6009SAO PAULO62140510ABC12345676304XXXX",
  "amount": 100.0,
  "pixKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "externalId": "pedido_12345"
}

​
Validação de Valor

A Owem realiza validação automática do valor informado contra o valor codificado no QR Code:
Tipo de QR CodeComportamento
QR Code com valor definidoO amount deve ser idêntico ao valor do QR Code
QR Code estático (sem valor)Você pode informar qualquer valor no campo amount
Validação de ValorSe o QR Code possuir um valor definido e o amount enviado for diferente, a transação será rejeitada instantaneamente com erro AMOUNT_MISMATCH.Apenas QR Codes estáticos sem valor pré-definido permitem que você informe um valor diferente.
Transações InterbancáriasEste endpoint não permite pagamentos para contas de outros bancos (transações interbancárias). Para transferências externas, utilize o endpoint de Transferência Externa.Para transferências entre contas internas da Owem, utilize a Transferência Interna.

​
Campos da Response

CampoTipoDescrição
idstringID único do pagamento
idempotencyKeystringChave de idempotência
externalIdstringID externo informado na requisição
typestringTipo: debit
reasonstringMotivo: pix_out:emv_pay
statusstringStatus: succeeded, pending, failed
grossAmountnumberValor bruto do pagamento
feeAmountnumberTaxa cobrada
netAmountnumberValor líquido
endToEndIdstringID único da transação PIX
accountIdstringConta de origem
payerobjectDados do pagador
receiverobjectDados do recebedor (do QR Code)
createdAtnumberTimestamp de criação (ms)
createdDatestringData de criação (YYYY-MM-DD)

​
Erros

CódigoCódigo ErroDescrição
400INVALID_DATADados inválidos ou incompletos
400INVALID_EMVEMV inválido ou expirado
400INTERBANK_NOT_ALLOWEDTransações interbancárias não permitidas
400AMOUNT_MISMATCHValor não confere com o QR Code (deve ser idêntico)
403-Sem permissão para esta conta
404-Conta de origem não encontrada
422INSUFFICIENT_BALANCESaldo insuficiente

​
Quando Usar Cada Endpoint

CenárioEndpoint Recomendado
Pagar QR Code PIX (mesma infra)Pagar QR Code (EMV)
Transferir para conta OwemTransferência Interna
Transferir para outro bancoTransferência Externa
O código EMV é a string que representa o QR Code PIX. Você pode obtê-lo através de leitura de câmera ou copiando o “PIX Copia e Cola”.
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "success": true,
  "size": 1,
  "data": {
    "metadata": {
      "idempotencyKey": "debit:pix_out:emv_pay:E37839059202501081200ABC123"
    },
    "type": "debit",
    "reason": "pix_out:emv_pay",
    "status": "succeeded",
    "grossAmount": 100.0,
    "feeAmount": 0,
    "netAmount": 100.0,
    "externalId": "pedido_12345",
    "endToEndId": "E37839059202501081200ABC123",
    "parentEndToEndId": null,
    "entryId": null,
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "userId": "usr_abc123def",
    "accountId": "572471114780",
    "createdAt": 1736337600000,
    "createdDate": "2025-01-08",
    "updatedAt": 1736337600000,
    "updatedDate": "2025-01-08",
    "payer": {
      "ispb": "37839059",
      "personType": "company",
      "cpfCnpj": "12345678000199",
      "name": "EMPRESA PAGADORA LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "572471114780"
    },
    "receiver": {
      "ispb": "37839059",
      "personType": "person",
      "cpfCnpj": "12345678900",
      "name": "JOAO DA SILVA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "987654321098"
    },
    "medId": null,
    "medCreatedAt": null,
    "medCreatedDate": null,
    "refundedEndToEndId": null,
    "errorMessage": null,
    "id": "E37839059202501081200ABC123",
    "idempotencyKey": "debit:pix_out:emv_pay:E37839059202501081200ABC123"
  }
}