Passar para o conteúdo principal
Gerando o PIX por API

Nesse artigo, descubra como utilizar a API do PIX

Diego Pancera avatar
Escrito por Diego Pancera
Atualizado há mais de uma semana

Nesse artigo, temos:


Gerando o PIX

Quando falamos em geração de PIX, podemos trabalhar com dois métodos:

  • GerarPix

Com esse método, é possível gerar o Pix para uma conta a receber já existente, se nenhum dado do cliente ou da conta a receber for informado, uma nova conta a receber será criada!

Nesse exemplo, vamos gerar um Pix vinculando a conta a receber já existente no Omie:

{
"call": "GerarPix",
"app_key": "XXXXXXXXXXXXX",
"app_secret": "XXXXXXXXXXXXXXXXX",
"param": [
{
"cCodIntPix": "1670867357",
"nCodTitulo": 1262961171
}
]
}

Como informamos a tag "nCodTitulo" não é necessário informar nenhuma outra tag de valor ou dados do cliente, pois ele vai puxar todas as informações da conta a receber!

A response, vem com todos os dados do Pix:

{
"nIdPix": 1262964224,
"cCodIntPix": "1670867357",
"cUrlPix": "XXXXXXXXXXXXXXXXXX",
"cQrCode": "XXXXXXXXXXXX",
"cCopiaCola": "XXXXXXXXXXXXXXXXXX",
"cCodStatus": "0",
"cDescStatus": "PIX gerado com sucesso!"
}

📌 Dicas Importantes

  • A tag "cCodStatus" quando apresenta '0' significa que a solicitação foi executada com sucesso

  • Se o retorno for maior que '0' ocorreu algum erro durante o processamento da solicitação

    • A tag 'cDesStatus' descreve o problema ocorrido

  • Caso queira gerar um Pix criando uma nova conta a receber, pode-se usar esse exemplo de requisição:

{
"call": "GerarPix",
"app_key": "XXXXXXXXXXXXX",
"app_secret": "XXXXXXXXXXXXX",
"param": [
{
"cCodIntPix": "1670867357",
"vValor": 10.0,
"nIdConta": 23124,
"nIdCliente" OU "cCnpjCpf": 1201934
}
]
}

Lembrando que: quando as tags 'cIdCliente' e cCnpjCpf' não informadas, assumirá que o PIX foi realizado para um cliente consumidor padrão. Caso não exista um cliente consumidor cadastrado, o mesmo será criado automaticamente

  • GerarQrCodePix

Nesse método, não é possível vincular uma conta a receber existente. Ou seja, ele deve ser usado quando for necessário cobrar por QR Code, mas sem um cliente ou outro dado definido que não seja o valor

Um exemplo de requisição que pode ser enviado é a seguinte:

{
"call": "GerarQrCodePix",
"app_key": "XXXXXXXXXXXXXXXX",
"app_secret": "XXXXXXXXXXXXXXXXXXXX",
"param": [
{
"vValor": 1.74
}
]
}

Lembrando que a tag "nIdConta" quando não preenchida, assumirá a Omie.CASH

Esse método em específico não cria a conta a receber! Quando o cliente pagar, será criado automaticamente um lançamento direto no extrato da conta corrente já conciliado:


Como listar os PIX

Para listar os dados do PIX, podemos trabalhar com os seguintes métodos:

Ambos utilizam a mesma estrutura na requisição:

 {
"call": "ListarStatusPix",
"app_key": "XXXXXXXXXX",
"app_secret": "XXXXXXXXXXXXX",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 200
}
]
}

Porém, os retornos serão diferentes. Confira:

  • ListarPix

Traz um retorno detalhado da listagem de PIX, com o link de acesso na tag "cUrlPix" e código para pagamento na tag "cCopiaCola". Além disso, traz as datas de vencimento e emissão:

{
"cCodIntPix": "",
"cCopiaCola": "XXXXXXXXXX",
"cStatus": "",
"cUrlPix": "XXXXXXXXXX",
"dEmissao": "10/02/2023",
"dVencimento": "11/02/2023",
"nIdPix": 548097326,
"vValor": 10
}

  • ListarStatusPix

{
"cCodIntPix": "",
"cStatus": "REGISTRADO",
"nIdPix": 1171377772,
"vValor": 10
}


Como obter dados do PIX

Para obter dados de um PIX específico, podemos trabalhar com os seguintes métodos:

Ambos utilizam a mesma estrutura na requisição:

{
"call": "",
"app_key": "XXXXXXXXXX",
"app_secret": "XXXXXXXXXX",
"param": [
{
"nIdPix": 1171362012
}
]
}

Porém, os retornos são diferentes. Confira:

  • ObterPix

{
"nIdPix": 1175969877,
"cCodIntPix": "",
"vValor": 5.5,
"dEmissao": "24/11/2022",
"dVencimento": "25/11/2022",
"cUrlPix": "XXXXXXXXXXXXXXXXX",
"cQrCode": "XXXXXXXXXXXXXXXXX",
"cCopiaCola": "XXXXXXXXXXXXXXXXX",
"cStatus": "REGISTRADO",
"cInfo": null
}
  • ObterStatusPix

{
"nIdPix": 1175969877,
"cCodIntPix": "",
"vValor": 5.5,
"cStatus": "REGISTRADO"
}


Cancelando o PIX

Pode ocorrer também de precisarmos cancelar o PIX! Para isso, utilizaremos o método "CancelarPix"

⚠️ Importante

Ao enviarmos a requisição de cancelar Pix, por padrão, a conta a receber também será excluída! Caso não queira que isso aconteça, é necessário enviar a tag "lDel", conforme descrita nos exemplos abaixo!

  • Caso queira excluir também a conta a receber

Não é necessário o envio da tag "lDel", pois o valor dela por padrão é "True"

{
"call": "CancelarPix",
"app_key": "XXXXXXXXXXXX",
"app_secret": "XXXXXXXXXXXX",
"param": [
{
"nIdPix": 1240017623
}
]
}
  • Caso não queira excluir a conta a receber

Deve ser enviada a tag "lDel" com o valor False, conforme exemplo abaixo:

{
"call": "CancelarPix",
"app_key": "XXXXXXXXXXXX",
"app_secret": "XXXXXXXXXXXX",
"param": [
{
"nIdPix": 1240017623,
"lDel": "F"
}
]
}

Respondeu à sua pergunta?