Pular para o conteúdo principal
POST
https://api.owem.com.br
/
v4
/
i
/
bank-accounts
/
{accountId}
/
transfer
/
pay
Pagar QR Code
curl --request POST \
  --url https://api.owem.com.br/v4/i/bank-accounts/{accountId}/transfer/pay \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emv": "<string>",
  "amount": 123,
  "externalId": "<string>",
  "metadata": {}
}
'
{
  "requestId": "f7a8b9c0-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
  "success": true,
  "size": 1,
  "data": {
    "metadata": {
      "idempotencyKey": "debit:pix_out:emv_pay:E378390592026011314520QRCPAY7X9"
    },
    "type": "debit",
    "reason": "pix_out:emv_pay",
    "status": "succeeded",
    "grossAmount": 150.0,
    "feeAmount": 0.12,
    "netAmount": 150.12,
    "externalId": "TX-20260113-PAGQR-001",
    "endToEndId": "E378390592026011314520QRCPAY7X9",
    "parentEndToEndId": null,
    "entryId": "a3b4c5d6e7f8901234567890",
    "requestId": "f7a8b9c0-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
    "userId": "usr_mkt7h2x9p4q",
    "accountId": "378390598712",
    "createdAt": 1736774520000,
    "createdDate": "2026-01-13",
    "updatedAt": 1736774520000,
    "updatedDate": "2026-01-13",
    "payer": {
      "ispb": "37839059",
      "personType": "company",
      "cpfCnpj": "45123678000195",
      "name": "TECH SOLUTIONS PAGAMENTOS LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "378390598712"
    },
    "receiver": {
      "ispb": "20018183",
      "personType": "company",
      "cpfCnpj": "28456912000143",
      "name": "SPRBT INTERACTIVE BRASIL LTDA",
      "agency": "0001",
      "accountType": "payment",
      "accountNumber": "1234567890"
    },
    "medId": null,
    "medCreatedAt": null,
    "medCreatedDate": null,
    "refundedEndToEndId": null,
    "errorMessage": null,
    "id": "E378390592026011314520QRCPAY7X9",
    "idempotencyKey": "debit:pix_out:emv_pay:E378390592026011314520QRCPAY7X9"
  }
}

​
Finalidade

Realiza pagamentos PIX através do código EMV (copia-e-cola). Permite pagar QR Codes dinâmicos e estáticos de qualquer instituição financeira. A API registra a operação na Ledger e retorna imediatamente o status inicial. Em caso de processing, a liquidação é assíncrona.

​
Autenticação

​
Authorization
string
obrigatório
Basic Auth obrigatório no formato: Basic {Base64(API_KEY:API_SECRET)}

​
Path Parameters

​
accountId
string
obrigatório
Conta de origem do pagamento na Owem (12 dígitos)

​
Request Body

​
emv
string
obrigatório
Código PIX copia-e-cola (EMV). Exemplo: 00020126360014BR.GOV.BCB.PIX0114...
​
amount
number
Valor do pagamento em BRL. Opcional: se não informado, utiliza o valor definido no QR Code.
​
externalId
string
Identificador único definido pelo cliente para idempotência e rastreabilidade
​
metadata
object
Objeto com dados personalizados que serão retornados na resposta e webhook

​
Resposta

​
requestId
string
UUID para rastreio
​
success
boolean
Status da operação
​
size
number
Quantidade de itens retornados
​
data
object
{
  "requestId": "f7a8b9c0-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
  "success": true,
  "size": 1,
  "data": {
    "metadata": {
      "idempotencyKey": "debit:pix_out:emv_pay:E378390592026011314520QRCPAY7X9"
    },
    "type": "debit",
    "reason": "pix_out:emv_pay",
    "status": "succeeded",
    "grossAmount": 150.0,
    "feeAmount": 0.12,
    "netAmount": 150.12,
    "externalId": "TX-20260113-PAGQR-001",
    "endToEndId": "E378390592026011314520QRCPAY7X9",
    "parentEndToEndId": null,
    "entryId": "a3b4c5d6e7f8901234567890",
    "requestId": "f7a8b9c0-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
    "userId": "usr_mkt7h2x9p4q",
    "accountId": "378390598712",
    "createdAt": 1736774520000,
    "createdDate": "2026-01-13",
    "updatedAt": 1736774520000,
    "updatedDate": "2026-01-13",
    "payer": {
      "ispb": "37839059",
      "personType": "company",
      "cpfCnpj": "45123678000195",
      "name": "TECH SOLUTIONS PAGAMENTOS LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "378390598712"
    },
    "receiver": {
      "ispb": "20018183",
      "personType": "company",
      "cpfCnpj": "28456912000143",
      "name": "SPRBT INTERACTIVE BRASIL LTDA",
      "agency": "0001",
      "accountType": "payment",
      "accountNumber": "1234567890"
    },
    "medId": null,
    "medCreatedAt": null,
    "medCreatedDate": null,
    "refundedEndToEndId": null,
    "errorMessage": null,
    "id": "E378390592026011314520QRCPAY7X9",
    "idempotencyKey": "debit:pix_out:emv_pay:E378390592026011314520QRCPAY7X9"
  }
}

​
Códigos de Status

HTTPDescrição
200Pagamento registrado
400EMV inválido ou transação não permitida
401Credenciais inválidas
403IP não allowlisted
404accountId não encontrado
422Saldo insuficiente ou limite excedido
429Rate limit excedido
500Erro interno

​
Status do Pagamento

StatusDescrição
processingRegistrado, aguardando confirmação bancária
succeededPagamento confirmado
failedFalha (QR inválido, rejeição bancária)

​
Exemplo de Request

{
  "emv": "00020101021226910014br.gov.bcb.pix2569qrcode.ip-digital.com/pc/p/v2/df2c0b69d1e44523a283975ffc9108605204799553039865802BR5925SPRBT INTERACTIVE BRASIL 6012Sao Paulo/SP61080133290762070503***63042E7F",
  "amount": 150.0,
  "externalId": "TX-20260113-PAGQR-001",
  "metadata": {
    "orderId": "12345",
    "customField": "valor_personalizado"
  }
}
Quando o campo amount não é enviado, a API utiliza automaticamente o valor definido no QR Code dinâmico.
QR Codes expirados ou já pagos retornarão erro 400. Verifique a validade do código antes de enviar.
Use externalId para garantir idempotência e facilitar a reconciliação das operações no seu sistema.