Skip to main content

Efí Exclusive Endpoints

The endpoints listed in this section aim to facilitate the use of the Pix API for Efí clients. With the following endpoints, you can obtain and modify information from your account directly through the API, according to the needs of your integration.


Create EVP Key​

Endpoint used to create a random Pix key (evp).

POST /v2/gn/evp
Requires authorization for the scope: gn.pix.evp.write


Request

The request sent to this endpoint does not require a body, only the OAuth authorization headers and the account certificate, just like the previous endpoints.


Responses

The responses below represent Success(201) and consumption failures/errors.

{
  "chave": "345e4568-e89b-12d3-a456-006655440001"
}

List EVP Keys​

Endpoint used to list random Pix keys (evp). The listing will only show keys of the random type.

GET /v2/gn/evp
Requires authorization for the scope: gn.pix.evp.read


Request

The request sent to this endpoint does not require a body, only the OAuth authorization headers and the account certificate, just like the previous endpoints.

Responses

The responses below represent Success(200) and consumption failures/errors.

{
  "chaves": [
    "355e4568-e89b-1243-a456-006655440001",
    "133e4568-e89b-1243-a456-006655440000"
  ]
}

Remove EVP Key​

Endpoint used to remove a random Pix key (evp). It is important to note that, when removing a random key, it will not be possible to create it again because the uuid is generated by DICT and each registration request results in a different hash. This means that charges created for the removed key can no longer be paid because the payload will no longer be returned.

DELETE /v2/gn/evp/:chave
Requires authorization for the scope: gn.pix.evp.write


Responses

The responses below represent Success(200) and consumption failures/errors.

Removed random key.

Get Account Balance​

Endpoint designed to check the balance in your Efí account. You can enable the scope in the settings of your application in your Efí account.

GET /v2/gn/saldo/
Requires authorization for the scope: gn.balance.read


Request

The request sent to this endpoint does not require a body, with the option to specify the bloqueios parameter as true or false, as shown in the code snippet below. This parameter displays or hides balances blocked by MED or judicial action.

/v2/gn/saldo?bloqueios=true

Responses

The responses below represent Success(200) and consumption failures/errors.

//Bloqueios = true
{
  "saldo": "100.00",
  "bloqueios": {
    "judicial": "0.00",
    "med": "0.00",
    "total": "0.00"
  }
}

Create/modify account settings​

Endpoint designed to create and modify account settings related to the API client.

Through this endpoint, you can define whether you want to exclusively receive a Pix through a transfer via key (receberSemChave = false), or allow receipts also through bank data (receberSemChave = true). In addition to the account configuration, it can also be used to modify Pix receipt settings associated with a specific key, such as allowing receipt without a txid, or blocking receipt by document type CPF or CNPJ, for example, and tariff and/or payer information in the webhook.

For more information about this endpoint, visit the Module 5.1 of our online course.

PUT /v2/gn/config
Requires authorization for the scope: gn.settings.write


Request

{
  "pix": {
      "receberSemChave": true,
      "chaves": {
          "355e4568-e89b-1243-a456-006655440001": {
              "recebimento": {
                  "txidObrigatorio": false,
                  "recusarTipoPessoa": "PF",
                  "qrCodeEstatico": {
                      "recusarTodos": false
                  },
                  "webhook": {
                      "notificacao": {
                          "tarifa": true,
                          "pagador": true
                      },
                      "notificar": {
                          "pixSemTxid": true
                      }
                  }
              },
              "envio": {
                  "webhook": {
                      "notificacao": {
                          "tarifa": true,
                          "favorecido": true
                      }
                  }
              }
          }
      }
  }
}

Responses

The responses below represent Success(204) and consumption failures/errors.

Configurações criados / modificadas

List account settings​

Endpoint used to list the settings defined in the account.

GET /v2/gn/config
Requires authorization for the scope: gn.settings.read


Request

The request sent to this endpoint does not require a body, only the OAuth authorization headers and the account certificate, as with the previous endpoints.Responses

The response below represent Consumption Success (200).

{
  "pix": {
    "receberSemChave": true,
    "chaves": {
      "355e4568-e89b-1243-a456-006655440001": {
        "recebimento": {
          "txidObrigatorio": true,
          "recusarTipoPessoa": "PF",
          "qrCodeEstatico": {
              "recusarTodos": false
          }
        }
      }
    }
  }
}

List account MED infractions​

Endpoint to list open violations on an account.

GET /v2/gn/infracoes
Requires authorization for the scope: gn.infractions.read


Request

The code snippet below illustrates the consumption of the endpoint in a request with as few parameters as possible (the inicio and fim date range) and the format in which these parameters should be passed on.

/v2/gn/infracoes?inicio=2020-10-22T00:00:000Z&fim=2023-12-30T23:00:000Z

Responses

The responses below represent Success(200) and consumption failures/errors.

{

  "parametros":{
    "inicio":"2023-11-22T16:01:35Z",
    "fim":"2023-12-22T16:01:35Z",
    "paginacao":{
       "paginaAtual":0,
       "itensPorPagina":10,
       "quantidadeDePaginas":2,
       "quantidadeTotalDeItens":20
    }
  },
  "infracoes":[
    {
      "idInfracao":"8ad75c93-6150-422c-929e-822f361c7a6b",
      "endToEndId":"E09089356202312181249APId91a6304",
      "protocolo":"1313",
      "dataTransacao":"2023-12-22T16:01:35Z",
      "valor":"100",
      "chave": "[email protected]", //OPTIONAL
      "status": "ABERTA", //ENUM["ABERTA", "ACEITA", "CANCELADA_EFI", "CANCELADA_EFI", "EM_DEFESA", "REJEITADA"]"razao":"Solicitacao de devolução",
      "tipoSituacao": "golpe", //OPTIONAL. ENUM["golpe", "aquisição da conta", "coerção", "acesso fraudulento", "outro", "desconhecido"]
      "tipoFraude": "aplicativo fraudulento", //OPTIONAL.
      "comentario": "Transação feita através de Qrcode falso em boleto", //OPTIONAL
      "defesa": "Comentario de defesa", //OPTIONAL 
      "justificativaAnalista": "Não foi identificado a fraude", //OPTIONAL
      "identificadorTicket":[
          94,
          95
      ],
      "dadosAnalise":{
          "abertura":"2023-12-22T16:01:35Z",
          "prazoFinalizacao":"2023-12-22T16:01:35Z",
          "recebimentoDefesa": "2023-12-22T16:01:35Z", //OPTIONAL 
          "finalizacao": "2023-12-22T16:01:35Z" //OPTIONAL
      },
      "origem":{
          "nomeParticipante":"BANCO XYZ",
          "conta":"10001",
          "nome":"Fulano de Tal",
          "documento":"800000000000000"
      },
      "destino":{
          "nomeParticipante":"Efí S/A",
          "conta":"10001",
          "nome":"Fulano de Tal",
          "documento":"800000000000000"
      },
      "criadoEm":"2023-12-22T16:01:35Z",
      "atualizadoEm":"2023-12-22T16:01:35Z"
    }
  ]
}

Submit MED infringement defense​

Endpoint that allows you to create a defense for a specific offense.

POST /v2/gn/infracoes/:idInfracao/defesa
Requires authorization for the scope: gn.infractions.write


Request

{
  "analise": "aceito",
  "justificativa": "Justificativa"
}

Responses

The responses below represent Success(201) and consumption failures/errors.

MED infringement defense created

Request Reconciliation Extract​

Endpoint for requesting a reconciliation extract.

POST /v2/gn/relatorios/extrato-conciliacao
Requires authorization for the scope: gn.reports.write


Request


{
  "dataMovimento": "2023-12-15",
  "tipoRegistros": {
    "pixRecebido": true,
    "pixEnviadoChave": true,
    "pixEnviadoDadosBancarios": true,
    "estornoPixEnviado": true,
    "pixDevolucaoEnviada": true,
    "pixDevolucaoRecebida": true,
    "tarifaPixEnviado": true,
    "tarifaPixRecebido": true,
    "estornoTarifaPixEnviado": true,
    "saldoDiaAnterior": true,
    "saldoDia": true,
    "transferenciaEnviada": true,
    "transferenciaRecebida": true,
    "estornoTransferenciaEnviada": true,
    "tarifaTransferenciaEnviada": true,
    "estornoTarifaTransferenciaEnviada": true,
    "estornoTarifaPixRecebido": true
  }
}

Responses

The responses below represent Success(201) and consumption failures/errors.

{
  "id": "3d0ca315-aff9–4fc2-be61–3b76b9a2d798",
  "dataSolicitacao": "“2022-02-14T14:42:51.013Z",
  "status": "AGUARDANDO_PROCESSAMENTO"
}

Types of status returned in the body:

  • AGUARDANDO_PROCESSAMENTO: This status indicates that the extract request was successfully received and is queued awaiting processing to begin;
  • EM_PROCESSAMENTO: This status indicates that the file generation has started and is in the process of processing the data;
  • CONCLUIDO: This status indicates that a extract with the same parameters was previously requested and a file with the returned id is now available for download.

Best Practice

After making the POST request, the API has an average waiting time of 30 seconds to process the extract. Therefore, it is recommended to wait for this time before making the GET request.


Request Download Reconciliation Extract​

Endpoint to request the download of the reconciliation extract.

GET /v2/gn/relatorios/:id
Requires authorization for the scope: gn.reports.read


Attention!

If you consume the GET endpoint and the extract not yet been processed, the response will be success(202), and the return will be similar to what is returned in the request, informing which processing step the request is in.


Responses
The responses below represent Success(200) and consumption failures/errors.
CA;Gerencianet;364;1;517613;João da Silva;2021-12-17;2021-12-10;Extrato de Conciliação API Pix;1.0
T;0;0;0;0;0;0

Return Details

For more information about the .CSV document that is returned and the legend of the fields, download the PDF available below or through this link.


Last updated on