> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pagamentos.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Efí

> Integre cobranças Pix da Efí com autenticação mTLS

## Sobre a Efí

A Efí oferece infraestrutura financeira e APIs de pagamento. A interface
unificada do **pagamentos.dev** é deliberadamente focada na API Pix para não
misturar credenciais e protocolos de produtos diferentes.

Consulte a [documentação oficial da API Pix Efí](https://dev.efipay.com.br/docs/api-pix/).

## Métodos e recursos

* `pix` — cobrança imediata com QR Code
* Consulta, atualização e cancelamento de cobranças
* Webhooks da API Pix

## Credenciais, certificado e sandbox

Crie uma aplicação Pix para obter `clientId`, `clientSecret`, chave Pix e o
certificado P12/PFX. O sandbox possui credenciais e host próprios.

```ts pagamentos.ts theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { readFile } from 'node:fs/promises'
import { Pagamentos, efi } from 'pagamentos'

const pfx = await readFile(process.env.EFI_PFX_PATH!)

export const pg = new Pagamentos({
  providers: [
    efi({
      clientId: process.env.EFI_CLIENT_ID!,
      clientSecret: process.env.EFI_CLIENT_SECRET!,
      pixKey: process.env.EFI_PIX_KEY!,
      mode: 'sandbox',
      pfx,
      pfxPassphrase: process.env.EFI_PFX_PASSPHRASE,
      signingSecret: process.env.EFI_WEBHOOK_SECRET
    })
  ]
})
```

<Warning>
  Nunca inclua o certificado, sua senha ou as credenciais no repositório. A API
  Pix exige autenticação mTLS também no sandbox.
</Warning>

O `signingSecret` protege a URL quando você usa o modo de webhook sem mTLS
documentado pela Efí.

Veja também [Pix](/metodos/pix) e [webhooks](/features/webhooks).