---
title: "NFe.io (legado)"
url: "https://devcenter.stone.com.br/legacy-nfeio"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_NFe.io+(legado),props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktbmZlaW8i,s_nv-ckfTlAw7X8nr6.png"
---

# NFe.io

Integração Pagar.me + NFe.io para emissão automática de notas fiscais de serviço.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

## [Overview](#overview)

O **NFe.io** é uma integração que conecta a plataforma de pagamento Pagar.me com uma solução de emissão de notas fiscais. Qualquer pedido e pagamento gerado em sua loja da Pagar.me irá passar pela emissão de nota fiscal no app.

## [Pré-requisitos](#pré-requisitos)

-   Conta Pagar.me com API V5
-   Conta ativa no **NFe.io**
-   Empresa cadastrada para Nota Fiscal de Serviço (NFS-e)

## [Etapas da integração](#etapas-da-integração)

### [Configuração do NFe.io](#configuração-do-nfeio)

Você deve coletar três informações essenciais:

1.  **API Key** — encontrada nas configurações da empresa sob "Chaves de Acesso"
2.  **Código de Serviço** — código numérico específico do serviço municipal
3.  **Empresa ID** — identificação da empresa no sistema NFe.io

### [Integração com o Hub Pagar.me](#integração-com-o-hub-pagarme)

Acesse o Hub Pagar.me, localize o app NFe.io na categoria **Financeiro** e clique em **Integrar com Pagar.me**. Insira as três informações coletadas acima.

## [Opções de configuração](#opções-de-configuração)

-   **Sempre emitir nota fiscal** — ativa emissão automática após pagamento
-   **Sempre cancelar nota fiscal** — cancela automaticamente quando pedido é cancelado
-   **Descrição da Nota Fiscal** — personalizável com variáveis como `{name}`, `{code}`, `{items}`
-   **CEP padrão** — usado quando o código IBGE não é encontrado

## [Suporte a metadata](#suporte-a-metadata)

A integração permite enviar metadatas para controlar comportamentos específicos, como ajustes de valor, habilitação/desabilitação de emissão e rastreamento de erros.

---

**Jornada: [HUB e apps](https://devcenter.stone.com.br/legacy-hub)**  
Etapa 5 de 7

[**Etapa anterior**Parceiros](https://devcenter.stone.com.br/legacy-hub-parceiros)[**Próxima etapa**Slack](https://devcenter.stone.com.br/legacy-slack)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.