Pular para o conteúdo

Desenvolvedores

Integre seu sistema à GetPrime.

APIs REST para o seu ERP, PDV ou sistema web cobrar na maquininha Smart do lojista e conciliar as vendas, sem digitar valor duas vezes.

O que dá para fazer

Conector POS

Seu sistema manda a cobrança e ela aparece na maquininha do lojista. O resultado volta com NSU, autorização e bandeira.

Ver documentação

Webhooks

Avisos assinados no seu servidor quando uma cobrança termina ou uma maquininha é vinculada.

Ver documentação

Consulta de vendas

Conta, saldo, vendas e maquininhas do estabelecimento, em JSON ou CSV, para conciliar no ERP.

Ver documentação

Como funciona o Conector POS, de ponta a ponta:

Fluxo
Seu sistema ──REST──▶ Conector POS ◀──HTTPS── App GetPrime na maquininha ──▶ adquirente
     ▲                      │
     └───── webhook ────────┘

Credenciais

Cada integração tem uma chave de API (ck_…), que vai no cabeçalho Authorization: Bearer, e um segredo de webhook (cs_…), que assina os avisos que enviamos ao seu servidor.

  • Lojista com sistema próprio: no Portal do Cliente, em Perfil › Conector POS, clique em Ativar Conector POS e informe o endereço do webhook.
  • Software house com vários clientes: fale com a GetPrime. Cadastramos o seu sistema como integrador, com a sua marca (logo, cores e fonte) aparecendo na maquininha durante a cobrança.

A chave e o segredo aparecem uma única vez

Guarde-os no servidor, nunca no navegador ou no aplicativo do caixa. Se vazarem, gere outros no mesmo lugar: os antigos param de valer na hora.

Convenções

ItemRegra
Endereço basehttps://api-app.ticketsprime.com.br/api/conector/v1
FormatoJSON em UTF-8, nomes de campos em camelCase.
ValoresSempre em centavos, inteiro: R$ 25,90 = 2590.
DatasISO 8601 em UTC, sempre com Z: 2026-10-26T14:32:08.512Z.
IdentificadoresGUID em texto. Guarde o id da cobrança e a sua referência juntos.
TransporteSomente HTTPS.

Erros

Respostas fora da faixa 2xx trazem uma mensagem em português, pronta para mostrar ao operador:

409 Conflict
{ "error": true, "message": "O terminal "Caixa 1" ja tem uma cobranca aberta (e4d3c2b1-…). Conclua ou cancele aquela." }
StatusQuando
400Dados inválidos (valor, tipo, parcelas, referência).
401Chave ausente, errada, trocada ou integração desativada.
404Terminal ou cobrança não existe (ou é de outro integrador).
409Conflito: terminal ocupado, referência repetida com outro valor, maquininha fora de uma conta ativa.

Suporte

Dúvidas na integração ou para cadastrar o seu sistema como integrador: WhatsApp (62) 99124-7197.