APIs Get Tech

Documentação completa para integração com as APIs de onboarding.

Explorar APIs Guia Rápido Exemplos de Código

APIs Disponíveis

Explore nossa suite completa de APIs para onboarding

Authentication

Sistema de autenticação e autorização para acesso seguro às APIs

POST /auth/token

Merchants - Person

Gestão de estabelecimentos comerciais pessoa física

POST /merchants

Merchants - Company

Gestão de estabelecimentos comerciais pessoa jurídica

POST /merchants

Offerings

Gerenciamento de ofertas e produtos financeiros

GET /offerings

Orders

Processamento e acompanhamento de pedidos

POST /orders

Establishment Contracts

Contratos de estabelecimentos comerciais

GET /contracts

Domains

Gerenciamento de domínios e configurações

GET /domains

Banks

Informações e operações bancárias

GET /banks

Centralizers

Centralizadores de transações e dados

GET /centralizers

Quiz

Sistema de questionários e validações

POST /quiz

Pins

Gerenciamento de PINs e códigos de segurança

POST /pins

Tracking

Rastreamento e monitoramento de processos

GET /tracking

Guia de Início Rápido

Comece a usar as APIs Getnet em poucos passos

Como começar

  1. Obtenha suas credenciais:
    Entre em contato com a equipe GetTech para receber suas chaves de API (client_id e client_secret)
  2. Autentique-se:
    Use a API de Authentication para obter um token de acesso
    POST /auth/token Content-Type: application/json { "client_id": "your_client_id", "client_secret": "your_client_secret", "grant_type": "client_credentials" }
  3. Faça sua primeira chamada:
    Use o token obtido para acessar qualquer endpoint das APIs
    GET /merchants Authorization: Bearer {access_token} Content-Type: application/json
  4. Explore a documentação:
    Clique em qualquer API acima para ver a documentação completa com exemplos e esquemas

Ambiente de Testes

Use os seguintes endpoints para desenvolvimento e testes (Sandbox):

https://api-homologacao.getnet.com.br

Nota: Sempre teste suas integrações no ambiente sandbox antes de usar em produção.

Glossário

Termos e conceitos importantes para entender as APIs Getnet

Acquirer

Pode referir-se tanto à empresa adquirente (que processa transações de cartão) quanto ao produto de adquirência (serviços e taxas relacionados ao processamento de pagamentos). Também usado para identificar recursos, configurações ou dados relacionados ao processo de aquisição de transações.

Authentication (Autenticação)

Processo de verificação de identidade para acessar sistemas protegidos.

Authorization (Autorização)

Header HTTP que contém o token de autorização necessário para acessar endpoints protegidos das APIs.

Bandeira

Marca do cartão de crédito ou débito (Visa, Mastercard, Elo, etc.).

Base64

Método de codificação que converte dados binários em texto ASCII para transmissão.

CNAE

Classificação Nacional de Atividades Econômicas - código que identifica a atividade principal de uma empresa.

CNPJ

Cadastro Nacional da Pessoa Jurídica - identificação única de empresas no Brasil.

CPF

Cadastro de Pessoas Físicas - identificação única de pessoas físicas no Brasil.

Legal Document Number

Número de documento legal - pode ser tanto o CNPJ quanto o CPF.

Domicílio Bancário

Conta bancária onde o estabelecimento recebe os valores das transações.

Endpoint

URL específica de uma API que aceita requisições para uma funcionalidade.

Establishment Contract

Contrato formal entre o adquirente e o estabelecimento comercial.

Hash

Função matemática que converte dados em uma sequência de caracteres de tamanho fixo.

HTTP Status Codes

Códigos numéricos que indicam o resultado de uma requisição (200=sucesso, 404=não encontrado, etc.).

JSON

Formato de dados leve usado para transmitir informações entre sistemas web.

MEI

Microempreendedor Individual - categoria empresarial simplificada para pequenos negócios.

Merchant (Estabelecimento)

Loja ou empresa que aceita pagamentos através da rede Getnet.

Merchant Account

Conta específica do estabelecimento para recebimento de pagamentos por bandeira/produto.

MCC (Merchant Category Code)

Código que classifica o tipo de negócio do estabelecimento comercial.

OAuth

Protocolo de autorização que permite acesso seguro a recursos sem expor credenciais.

Offering (Oferta)

Oferta disponível para estabelecimentos.

Onboarding

Processo de habilitação tanto de produtos ou credenciamento de estabelecimentos comerciais para receber pagamentos através dos produtos Getnet.

Order (Pedido)

Solicitação de pedido feita por um estabelecimento, pode ser tanto um credenciamento como uma habilitação de produto ou pedido de produto adicional ou qualquer produto que a Getnet oferte.

Payment Center

Centralizador de pagamentos que concentra recursos de múltiplos estabelecimentos.

Payload

Dados enviados no corpo de uma requisição HTTP.

PF (Pessoa Física)

Estabelecimento comercial registrado como pessoa física.

PJ (Pessoa Jurídica)

Estabelecimento comercial registrado como empresa.

PIN

Número de identificação pessoal usado para autenticação em transações.

Qualification (Qualificação)

Processo de análise e validação dos dados de um estabelecimento comercial ou pedido.

Response (Resposta)

Dados retornados pela API após processar uma requisição.

REST

Estilo arquitetural para APIs que usa métodos HTTP padrão (GET, POST, PUT, DELETE).

Sandbox

Ambiente de testes isolado onde desenvolvedores podem testar integrações com segurança.

Settlement (Liquidação)

Processo de transferência de valores das transações para o estabelecimento.

Settlement Period (Prazo de Liquidação)

Plano de recebimento para transferência de valores das transações para o estabelecimento.

Terminal

Equipamento físico (POS) usado para processar transações de cartão. Pode ser wifi, ethernet, GPRS ou TEF.

TEF

Transferência Eletrônica de Fundos - sistema que permite transações via software integrado.

MDR (Merchant Discount Rate)

Taxa percentual cobrada sobre cada transação de cartão processada pelo estabelecimento.

Pricing Model (Modelo de Precificação)

Forma de cobrança dos produtos: fixed_price (compra), monthly_rent (aluguel) ou MDR (taxa por transação).

Delivery Method

Forma de entrega de equipamentos: courrier (correios), presential (presencial) ou technical_support_visit (visita técnica).

Device

Equipamento auxiliar como pinpad, impressora ou acessório para terminais de pagamento.

Voucher

Produto relacionado a vale-refeição, vale-alimentação ou outros tipos de benefícios.

Natureza Jurídica

Classificação legal que define a forma de constituição de uma empresa (SA, LTDA, MEI, etc.).

Trade Name

Nome fantasia - nome comercial pelo qual a empresa é conhecida no mercado.

Legal Name

Razão social - nome oficial da empresa registrado nos órgãos governamentais.

Transaction Channel Type

Tipo de canal usado para transações: POS, miniPOS, e-commerce, mobile, etc.

Installment Type

Tipo de parcelamento: merchant (lojista assume juros) ou issuer (emissor do cartão assume).

Federal Registration Status

Situação cadastral do CPF/CNPJ nos órgãos federais: ativo, suspenso, inapto, etc.

UUID

Identificador único universal - código único gerado para identificar recursos.