G GRAFFIT PAY
INFRAESTRUTURA DE PAGAMENTOS · API FIRST

Pagamentos que entram.
Sistemas que continuam.

A Graffit Pay conecta checkout, PIX, identidade, eventos, ledger e settlement em uma única camada operacional. Sua plataforma integra uma API e recebe uma infraestrutura para operar; a Graffit cuida do ciclo financeiro.

API própria Idempotência HMAC Double-entry ledger Settlement gerenciado
GRAFFIT / LIVE FLOW SECURE CHANNEL
POST/v1/payment_intents201

01

02

03

04

05

PIXconfirmado
LEDGERregistrado
WEBHOOKentregue
INTEGRAÇÃO1 API

Uma superfície para operar pagamentos e clientes.

EVENTOSAssinados

Webhooks HMAC para mudança de estado em tempo real.

FINANCEIRORastreável

Ledger de dupla entrada e histórico por transação.

OPERAÇÃOGerenciada

Reconciliação e settlement ficam na camada Graffit.

O PRODUTO

Uma camada financeira para produtos digitais.

Integre o que seu negócio precisa sem transformar seu time em especialista em rails de pagamento. A Graffit centraliza criação, identificação, conciliação, eventos e registro financeiro.

01 PAYMENT INTENTS

Seu sistema cria a intenção. A Graffit conduz o ciclo.

Valor, referência, nome e CPF do pagador entram em uma chamada idempotente. O retorno fornece o checkout PIX e um identificador permanente para acompanhar a operação até o estado final.

POST/v1/payment_intents
02 WEBHOOKS

O status chega até você.

Eventos assinados notificam pagamento criado, PIX identificado e conclusão. Retry, histórico de deliveries e secret HMAC tornam a integração observável.

03 LEDGER

Cada movimento tem contrapartida.

O double-entry ledger mantém o histórico financeiro coerente, separando recebimento, taxa, clearing e liquidação com trilha por Payment Intent.

04 SETTLEMENT

Da confirmação à liquidação.

A plataforma acompanha a operação além do QR Code: reconcilia evidências, evita matches ambíguos e encerra o pagamento apenas quando existe confirmação suficiente.

05 IDENTIDADE

Clientes identificados sem misturar papéis.

Responsável da empresa e cliente final são entidades distintas. Nome e CPF acompanham o pagamento; fluxos que exigem cliente persistente podem usar customer_id e KYC.

DOIS MODELOS · UMA API

A arquitetura acompanha seu negócio.

Uma loja não precisa carregar a complexidade de uma plataforma com saldos por usuário. Por isso a Graffit separa os fluxos sem fragmentar a integração.

MODELO 01Vendas & checkout

Venda sem saldo separado por usuário.

Para lojas online, serviços, assinaturas, pedidos e plataformas que precisam cobrar e receber a confirmação sem manter uma conta financeira individual para cada comprador.

  • Payment Intent por pedido
  • Nome + CPF obrigatórios no pagamento
  • E-mail e telefone opcionais
  • PIX gerado pela API
  • Webhook para confirmar o ciclo
  • Financeiro bruto, taxa e líquido por merchant
Ver documentação de vendas →
MODELO 02Clientes & saldos

Dinheiro e movimentação separados por cliente.

Para plataformas em que cada usuário precisa de uma identidade financeira própria, histórico individual e visão de saldo segregada no ledger da Graffit.

  • customer_id permanente por usuário
  • Identidade e KYC quando aplicável
  • Movimentação associada ao cliente correto
  • Saldos separados por customer_id
  • Consulta de balances pela API
  • Auditoria por cliente e por transação
Ver documentação de clientes →
DO CHECKOUT AO ESTADO FINAL

O pagamento não termina no QR Code.

O estado financeiro precisa continuar correto mesmo depois que o cliente fecha a tela. A Graffit mantém o Payment Intent como fonte de verdade operacional.

01CRIAR

Intent idempotente

O pedido nasce com referência e identidade do pagador.

02COBRAR

PIX

O checkout recebe QR e copia-e-cola vinculados ao Intent.

03IDENTIFICAR

Evento assinado

A confirmação entra por webhook e passa por correlação segura.

04REGISTRAR

Ledger

Bruto, taxa e contrapartidas são registrados sem sobrescrever histórico.

05CONCLUIR

Settlement

A operação fecha e seu backend recebe o evento final.

SEGURANÇA POR ARQUITETURA

Controles no caminho crítico, não só na interface.

A segurança da integração é tratada em autenticação, repetição de chamadas, eventos, identidade, registro financeiro e reconciliação.

01

API Keys por ambiente

Credenciais TEST e LIVE separadas, revogáveis e exibidas integralmente apenas na criação.

02

Idempotência

Uma mesma operação pode ser repetida com segurança sem criar cobranças duplicadas quando a mesma chave idempotente é reutilizada.

03

Webhooks HMAC

Eventos carregam timestamp e assinatura para que seu backend valide autenticidade antes de alterar um pedido.

04

Double-entry ledger

Movimentações são registradas em partidas correspondentes, preservando uma trilha financeira verificável.

05

Identidade protegida

Dados sensíveis de KYC seguem fluxo dedicado e informações temporárias são protegidas no backend, sem exposição no checkout.

06

Reconciliação conservadora

A Graffit não conclui uma operação financeira com evidência ambígua. Estado final exige correlação suficientemente forte.

SOBRE A GRAFFIT PAY

Infraestrutura feita para desaparecer atrás de uma boa experiência.

A Graffit Pay é uma camada de infraestrutura para empresas que precisam incorporar pagamentos em produtos digitais sem espalhar lógica financeira crítica por diversos serviços.

Nossa arquitetura organiza merchant, cliente, Payment Intent, identidade, webhooks, ledger e settlement em um único fluxo rastreável. A empresa integra a Graffit; o usuário final continua enxergando a experiência da própria plataforma.

O objetivo é simples: reduzir a distância entre “o cliente pagou” e “o sistema sabe exatamente o que aconteceu”.

01API primeiro

Integração previsível e orientada a recursos.

02Estado explícito

Cada etapa financeira pode ser acompanhada.

03Segregação lógica

Merchants e clientes mantêm contexto financeiro próprio.

04Operação observável

Logs, eventos e histórico ajudam a diagnosticar o ciclo.

CONTRATO DE INTEGRAÇÃO

Simples por fora.
Rigoroso por dentro.

A integração pública trabalha com objetos claros e estados rastreáveis. Os detalhes operacionais de provedores, reconciliação e settlement permanecem encapsulados pela Graffit.

Abrir documentação técnica ↗
// criar pagamento
POST /v1/payment_intents
Authorization: Bearer gpk_live_...
Idempotency-Key: order_8f42

{
  "amount_brl": 149.90,
  "reference": "ORDER-8F42",
  "payer": {
    "name": "Nome do cliente",
    "cpf": "00000000000"
  }
}

// eventos
payment.created
pix.paid
payment.completed
PERGUNTAS FREQUENTES

O essencial antes da integração.

Respostas diretas para equipes técnicas, financeiras e de produto avaliando a Graffit Pay.

Uma única API Key LIVE atende toda a integração?+

Sim. A mesma credencial LIVE autentica os recursos disponíveis para o merchant. O webhook é o canal de retorno de eventos e possui um Secret HMAC separado para validação das assinaturas.

Como a plataforma sabe que um PIX foi pago?+

A Graffit acompanha o Payment Intent, recebe eventos do fluxo financeiro, correlaciona a operação e envia eventos assinados ao webhook do merchant. O estado final não depende apenas da tela do checkout.

Preciso criar um cliente para toda venda?+

Não. No modelo de vendas/checkout, o Payment Intent pode representar diretamente o pedido. No modelo de clientes e saldos, cada usuário mantém um customer_id persistente.

O comprador precisa fazer KYC em uma loja comum?+

Não por padrão no modelo de vendas diretas. Nome e CPF acompanham o pagamento. Fluxos com conta de cliente, saldo separado ou requisitos adicionais podem exigir identidade/KYC conforme o caso.

Como evitamos pagamentos duplicados?+

A criação de Payment Intents suporta Idempotency-Key. Repetir a mesma requisição com a mesma chave não deve ser tratado como uma nova cobrança independente.

Como confirmo que um webhook veio da Graffit?+

Seu backend usa o Secret HMAC para validar a assinatura e o timestamp enviados nos headers do evento antes de confiar no payload.

INTEGRAÇÃO & PARCERIAS

Quer avaliar a Graffit por dentro?

Fale com nosso time de integrações para discutir arquitetura, fluxo comercial, onboarding e requisitos técnicos da sua plataforma.