APIs REST para integracao de pagamentos

APIs de pagamento
PIX e Maquininhas

Integre pagamentos PIX e Smart POS no seu sistema em minutos. APIs RESTful, webhooks em tempo real, sandbox completo e documentacao interativa.

< 3s

Confirmacao PIX

REST

JSON + OAuth2

99.9%

Uptime SLA

Sandbox

Ambiente de testes

Integracao simples

Poucas linhas de codigo, pagamento funcionando

API PIXJavaScript
// Criar cobranca PIX
const response = await fetch('https://api.avpay.com.br/v1/cob', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {seu_token}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    companyId: 'uuid-da-empresa',
    valor: 150.00,
    devedorNome: 'Maria Silva',
    devedorCpf: '12345678901',
    expiracao: 3600,
  }),
});

const cob = await response.json();
// cob.qrCode    → PIX copia e cola
// cob.txid      → Identificador unico
// cob.location  → URL do QR Code
API Smart POSJavaScript
// Enviar pagamento para maquininha
const response = await fetch('https://api.avpay.com.br/v1/deposit-requests', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {seu_token}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    companyId: 'uuid-da-empresa',
    deviceId: 'uuid-do-dispositivo',
    amount: 89.90,
    method: 'CARD',
    cardOption: 'CREDIT',
    installments: 3,
    webhookCallback: 'https://seu-site.com/webhook',
  }),
});

const payment = await response.json();
// payment.id     → ID da transacao
// payment.status → PENDING → EXECUTED

API PIX

Integracao completa com o ecossistema PIX do Banco Central. Crie cobrancas, receba webhooks e reconcilie pagamentos. Toda a infraestrutura de seguranca e gerenciada por nos.

Certificados gerenciados pela AVPay
Autenticacao bancaria transparente
Webhook em tempo real
QR Code dinamico com expiracao

Cobrancas PIX (Cob)

Crie cobrancas com QR Code dinamico via API. Receba confirmacao de pagamento em tempo real via webhook.

Seguranca Gerenciada

Certificados digitais, chaves PIX e autenticacao bancaria sao configurados e gerenciados por nos. Voce so usa a API.

Webhooks de Pagamento

Receba notificacoes instantaneas quando uma cobranca e paga, expirada ou devolvida. Reconciliacao automatica.

Sync de Status

Consulte o status atualizado de qualquer cobranca diretamente no banco. Sincronizacao sob demanda ou automatica.

Multi-banco

Conecte-se a qualquer banco que implemente a API PIX do BACEN. Cada empresa pode ter seu proprio banco.

API Smart POS

Controle suas maquininhas remotamente via API. Envie pagamentos, gerencie dispositivos e receba callbacks de transacoes.

Debito, Credito (ate 12x) e PIX
Pagamento instantaneo
Webhook por transacao
PIX na maquininha (se habilitado)

Gestao de Dispositivos

Cadastre, vincule e gerencie maquininhas por empresa via API. Controle de ativacao e desativacao remota.

Pagamentos Cartao + PIX

Envie solicitacoes de pagamento para dispositivos. Suporte a debito, credito (ate 12x) e PIX na maquininha.

Callback de Transacao

Webhook configuravel por transacao. Receba o resultado do pagamento assim que processado no dispositivo.

Integra PIX Automaticamente

Se a empresa tem PIX habilitado, a maquininha aceita PIX nativamente. Sem configuracao adicional.

Assign por Codigo

Vincule dispositivos a empresas usando codigos de atribuicao. Ideal para onboarding self-service.

Historico e Relatorios

Consulte transacoes, filtre por status, metodo e periodo. Exporte dados via API para seu BI.

Referencia

Principais Endpoints

Autenticacao via JWT (Keycloak). Todas as respostas em JSON.

PIX/api/pix
POST/v1/cob
GET/v1/cob/{txid}
POST/v1/cob/{txid}/sync
GET/v1/cob/company/{id}
GET/v1/pix-keys/company/{id}
Smart POS/api/smart-pos
POST/v1/deposit-requests
GET/v1/deposit-requests/{id}
POST/v1/devices
POST/v1/devices/assign-codes/assign
GET/v1/devices/active
POST/v1/devices/{id}/reactivate

Integracao

Como integrar

01

Crie sua conta

Registre sua empresa e obtenha suas credenciais de API (client_id + client_secret).

02

Nos configuramos tudo

Nossa equipe configura certificados, chaves PIX e autenticacao bancaria. Voce recebe as credenciais de API prontas.

03

Integre a API

Use nossas APIs REST para criar cobrancas PIX e enviar pagamentos para maquininhas.

04

Receba webhooks

Configure URLs de callback para receber notificacoes de pagamento em tempo real.

Planos

Comece gratis, escale sem limites

Sandbox completo em todos os planos. Pague apenas quando for para producao.

Starter

Para validar sua integracao

  • Ate 500 chamadas API/mes
  • API PIX (cobrancas + consultas)
  • 1 dispositivo Smart POS
  • Webhooks basicos
  • Sandbox completo
  • Suporte por email
Comecar agora
Mais popular

Business

Para operacoes em producao

  • Chamadas API ilimitadas
  • API PIX + Smart POS completa
  • Ate 50 dispositivos
  • Webhooks + retry automatico
  • Multi-empresa (ate 10)
  • Dashboard + Export CSV
  • Suporte prioritario
  • SLA 99.5%
Comecar agora

Enterprise

Para grandes integradores

  • Volume ilimitado
  • Dispositivos ilimitados
  • Multi-tenant ilimitado
  • IP whitelist + rate limit custom
  • Suporte dedicado 24/7
  • SLA 99.9% garantido
  • Integracao assistida
  • Ambiente staging dedicado
Comecar agora

Integre PIX e Maquininhas hoje

Crie sua conta, obtenha suas credenciais e comece a testar no sandbox em minutos. Documentacao interativa com Swagger inclusa.