> For the complete documentation index, see [llms.txt](https://docs.gopag.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gopag.com.br/developers.md).

# Desenvolvedores/Integrações

Bem-vindo à documentação oficial da GoPag API! Esta API foi desenvolvida para facilitar a integração de soluções de pagamento em sua aplicação.

## 🎯 Objetivo

Prover uma camada de abstração e segurança para acesso aos serviços de pagamento da GoPag, permitindo que:

* **Partner (Marketplaces)** integrem seus sistemas com a plataforma de pagamentos e gerenciem seus sellers e transações de forma isolada e segura
* **Clientes Finais** acessem funcionalidades de pagamento de forma simplificada

## 🔐 Modelo de Autenticação e Segurança

### Marketplace Token (Atual)

O sistema utiliza um modelo de **marketplace virtual** onde cada parceiro possui:

* **Token de Marketplace**: Autenticação via OAuth2 (Bearer token) com certificado mTLS
* **Escopo Limitado**: Acesso restrito apenas aos sellers dentro do escopo do partner
* **Marketplace Virtual**: Cada parceiro opera em seu próprio "marketplace" com gestão independente

## 🚀 Principais Funcionalidades

### 📊 Gestão de Transações

* Criação de transações (cartão, boleto, Pix)
* Consulta de transações individuais e em lote
* Captura de transações pré-autorizadas
* Histórico completo de transações por seller

### 🖥️ Gestão de Terminais

Gerenciamento de dispositivos de pagamento:

* **Físicos**: Maquininhas tradicionais
* **Virtuais**:
  * Tap2Pay (pagamento por aproximação)
  * Aplicativos Android/iOS
* Pareamento de terminais
* Monitoramento de status

### 👥 Gestão de Sellers

* Listagem de sellers do marketplace
* Consulta de dados individuais
* Busca por CPF/CNPJ

### 💳 Gestão de Compradores (Buyers)

* CRUD completo de compradores
* Busca por CPF/CNPJ
* Validação de dados cadastrais

## 🔄 Fluxos de Pagamento Suportados

### Fluxo Tradicional

* **Cartão de Crédito/Débito**: Transações com captura imediata ou posterior
* **Boleto Bancário**: Geração e consulta de boletos
* **Pix**: Pagamentos instantâneos via QR Code ou Pix Copia e Cola

### Fluxo Inteligente

* **Cadastro de Link de Pagamento**: Criação automatizada de métodos de pagamento
* **Tap2Pay**: Integração nativa para pagamentos por aproximação

## 📚 Índice

### Introdução e Aspectos Gerais

* [Introdução](/developers/introducao/visao-geral.md)
* [Requisitos de Segurança](/developers/introducao/requisitos-seguranca.md)
* [Autenticação](/developers/introducao/autenticacao.md)
* [Testando a API](/developers/introducao/testando.md)
* [Códigos de Erro](/developers/introducao/codigos-erro.md)

### Cadastro e Credenciamento

#### Vendedores

* [Listando Vendedores](/developers/cadastro/vendedores/listar.md)
* [Buscando Vendedor por CPF/CNPJ](/developers/cadastro/vendedores/buscar-cpf-cnpj.md)
* [Recuperar Detalhes de Vendedor](/developers/cadastro/vendedores/detalhes.md)
* [Categoria MCC (Merchant Category Codes)](/developers/cadastro/vendedores/mcc.md)

#### Compradores

* [Gerenciar Compradores](https://github.com/Gestao-Online/gopag-public-docs/blob/master/DEVELOPERS/cadastro/compradores/compradores.md)

### Transações

* [Listar Transações](/developers/transacoes/listar.md)
* [Recuperar Detalhes de Transação](/developers/transacoes/detalhes.md)
* [Capturar Transação](/developers/transacoes/capturar.md)
* [Tokenizar Cartão](https://github.com/Gestao-Online/gopag-public-docs/blob/master/DEVELOPERS/transacoes/tokenizar.md)

#### Criar Transação - Via API

* [Cartão de Crédito/Débito](/developers/transacoes/criar-transacao-sem-checkout/cartao.md)
* [PIX](/developers/transacoes/criar-transacao-sem-checkout/pix.md)
* [Boleto e Bolepix](/developers/transacoes/criar-transacao-sem-checkout/boleto.md)

#### Criar Transação - Payment Locales

* [MPOS](/developers/transacoes/criar-transacao-maquininhas-e-celular/mpos.md)
* [Tap to Pay (NFC)](/developers/transacoes/criar-transacao-maquininhas-e-celular/tap-to-pay.md)
* [PINPAD](/developers/transacoes/criar-transacao-maquininhas-e-celular/pinpad.md)
* [Link de Pagamento](/developers/transacoes/criar-transacao-checkout-gopag/link-pagamento.md)

## 🚀 Começando

Para começar a usar a GoPag API, você precisará:

1. **Bearer Token**: Obtido via Portal GoPag ou enviado pela GoPag (Entre em contato para solicitar)
2. **Certificado mTLS**: Certificado ICP-Brasil para autenticação bidirecional
3. **Marketplace ID**: Identificador único do seu marketplace
4. **Ambiente**: URLs de homologação e produção

Consulte a seção [Autenticação](/developers/introducao/autenticacao.md) para mais detalhes.

## 🔒 Segurança

A GoPag API utiliza:

* **Bearer Token**: Autenticação via OAuth 2.0
* **mTLS (Mutual TLS)**: Autenticação bidirecional com certificados ICP-Brasil
* **Isolamento por Marketplace**: Cada marketplace só acessa seus próprios dados

## 📞 Suporte

Para suporte técnico, dúvidas sobre integração ou solicitação de credenciamento:

📧 Email: <suporte@gopag.com.br>