Integrator

Desenvolvedores

Visão geral

A API do Integrator transforma uma requisição HTTP em uma cobrança na maquininha. Esta documentação cobre tudo o que você precisa para integrar, do primeiro teste à produção.

1 · Seu servidor

POST /v1/charges

Cria a cobrança com a sua API key.

→

2 · Maquininha

app Integrator

Busca a cobrança em até 1 s e abre o pagamento na maquininha.

→

3 · Seu webhook

charge.approved

Recebe o resultado assinado com NSU e autorização.

Conceitos

  • Conta: sua empresa no Integrator. Tem saldo de créditos, terminais, API keys e um webhook.
  • Terminal: uma maquininha pareada. Cada terminal tem um id (usado na API), um token secreto que fica só no aparelho e um PIN para as configurações do app.
  • API key: a credencial do seu servidor (itg_live_…). Nunca coloque no front-end nem na maquininha.
  • Cobrança: um pedido de pagamento com valor e método (credit, debit ou pix) enviado para um terminal.
  • Webhook: a URL do seu sistema que recebe o resultado de cada cobrança.
  • Créditos: saldo pré-pago (1 crédito = R$ 0,01) consumido só por cobranças aprovadas.

URL base e formato

Todas as chamadas usam HTTPS e JSON:

URL base
https://api.integrator.co26.com.br
  • Valores monetários são sempre inteiros em centavos: R$ 12,50 vira 1250.
  • Datas usam ISO 8601 em UTC, por exemplo 2026-10-13T18:20:11.204Z.
  • Campos e parâmetros usam snake_case.
  • Listas são paginadas por cursor: envie o next_cursor recebido para buscar a próxima página.

Endpoints

POST/v1/charges
GET/v1/charges/{id}
GET/v1/charges
POST/v1/charges/{id}/cancel
GET/v1/terminals
GET/v1/balance

A especificação completa em OpenAPI está na Referência da API.

Pressa?

Siga o Início rápido: em uns 10 minutos você faz a primeira cobrança de verdade.
PróximoInício rápido →