API da Getnet: o que dá para fazer e como usar com agentes de IA
A Getnet oferece APIs de pagamento online para lojistas credenciados, com cartão, Pix, boleto, recorrência e consulta de transações. É usada por e-commerces, plataformas e empresas que já têm a Getnet como adquirente. O acesso exige credenciais da conta do lojista e ambiente de homologação.
Os grandes recursos da API, em português claro.
Autorização, captura e cancelamento de transações de crédito e débito.
Geração de cobranças Pix e boletos e consulta do pagamento.
Planos e assinaturas com cobrança automática.
Armazenamento seguro de cartões para compras futuras.
Avisos de mudança de status das transações.
Como se acessa a API do Getnet.
- Com credencial da sua empresaUsa OAuth 2.0 com client ID e client secret fornecidos à conta do lojista, além do identificador do estabelecimento, com credenciais separadas para homologação e produção.
- Documentação oficialdevelopers.getnet.com.br
- Dados de cartão seguem as regras do PCI DSS: o agente não deve manipular número de cartão.
- Cancelamentos e estornos precisam de aprovação e teto de valor.
- Use sempre o ambiente de homologação antes de produção.
- api getnet
- getnet api
- api getnet pix
- getnet developers
- api getnet boleto
- integração api getnet
- getnet api documentação
O que um agente do iTeam faz com a API do Getnet.
Quando o cliente pede, o agente gera um novo Pix ou boleto com o mesmo valor e envia pelo canal de atendimento.
O agente cruza as transações aprovadas com os pedidos e aponta capturas pendentes ou valores divergentes.
O agente localiza a transação, prepara o cancelamento e só executa após a aprovação do financeiro.
O agente identifica recorrências recusadas e organiza o contato com cada cliente.
Da credencial ao agente trabalhando, com aprovação.
Pedir as credenciais à Getnet
Com o credenciamento ativo, obtenha client ID, client secret e o identificador do estabelecimento para homologação.
Guardar no cofre do iTeam
Cadastre as credenciais no cofre, separando consulta de ações que mexem em valores.
Homologar e manter aprovação
Valide no ambiente de homologação e mantenha cancelamentos e estornos com aprovação humana.
Dúvidas sobre a API do Getnet.
A API da Getnet é gratuita?
O uso da API está ligado ao contrato de adquirência; os custos são as taxas acordadas por transação e produto, não uma tarifa pela API em si.
Preciso programar para usar a API da Getnet com o iTeam?
Não necessariamente. Com as credenciais em mãos, o time de implantação do iTeam configura as chamadas a partir da documentação da Getnet.
Preciso ser cliente Getnet?
Sim. As APIs de pagamento são para estabelecimentos credenciados na Getnet.
Como funciona a autenticação da API da Getnet para um sistema que cobra clientes?
A Getnet usa OAuth 2.0: o sistema troca client ID e client secret por um token de acesso e informa o identificador do estabelecimento nas chamadas. Há credenciais separadas para homologação e para produção, e o token tem validade curta, então precisa ser renovado. O agente nunca deve ver o secret em texto: ele pertence ao cofre da integração.
Como testar a integração com a Getnet antes de cobrar clientes de verdade?
A Getnet tem ambiente de homologação com credenciais próprias, distinto da produção. Faça nele os fluxos de cartão, Pix e boleto, simule aprovações e recusas e só depois troque as credenciais. Os números de cartão de teste e as regras de cada ambiente estão em developers.getnet.com.br, então confira ali o que está habilitado para a sua conta.
O agente de IA pode ver o número do cartão do cliente numa cobrança Getnet?
Não deve: dados de cartão estão sob as regras do PCI DSS, e o desenho correto é tokenizar e deixar o agente lidar apenas com o token e o status do pagamento. A API da Getnet oferece tokenização justamente para isso. O agente acompanha aprovação, recusa e estorno sem jamais tocar no número, e a coleta do cartão acontece em campo seguro.
Que tarefas um agente pode fazer com Pix e boleto da Getnet?
Gerar a cobrança, enviar o código ou o link ao cliente, consultar se foi pago e avisar o financeiro das pendências. Para boleto vencido, ele pode lembrar o cliente e oferecer a segunda via. Cancelamentos e estornos ficam sob aprovação humana com teto de valor. No iTeam, o agente faz o contato pelo WhatsApp e a conferência fica na trilha de auditoria.
Como o agente usa as notificações da Getnet para conciliar pagamentos?
Recebendo o aviso de mudança de status de cada transação e cruzando com o pedido no ERP, sem consultar a API o tempo todo. Quando o pagamento aprova, o agente marca o pedido como pago; quando recusa ou estorna, abre uma pendência para o financeiro. Divergências entre extrato e ERP vão para revisão de uma pessoa, não são corrigidas sozinhas.
A Getnet serve para uma PME que acabou de abrir a loja online?
Serve se a empresa for lojista credenciada na Getnet, que é quem recebe as credenciais da API. O onboarding técnico passa pelo credenciamento, pelas credenciais de homologação e pelos testes de cada meio de pagamento. Para quem ainda não tem adquirente, a escolha do provedor vem antes de qualquer agente: vale comparar taxas e documentação, e só então integrar.
Quando não compensa automatizar cobranças da Getnet com um agente de IA?
Quando o volume de cobranças é pequeno e o processo manual já resolve, ou quando as regras mudam toda semana sem documentação. Automatizar sem regra clara só acelera erros num fluxo que mexe com dinheiro. Vale quando há repetição, como confirmação de pagamento, segunda via e aviso de recusa.
O que acontece se o agente tentar fazer um estorno que não deveria na Getnet?
Se o estorno exigir aprovação, a ação fica pendente até alguém com alçada autorizar, e nada é enviado à Getnet antes disso. O controle é desenhado na plataforma, com teto de valor e registro de quem pediu e quem aprovou. A própria Getnet também aplica as regras do contrato do lojista, então confira na documentação o que a API permite estornar e em que prazo.
