Pular para o conteúdo

Para lojas, marketplaces e parceiros

Checkout plug & play.

Rode na sua infraestrutura. Qualquer sistema conversa com ele por um token assinado — sem SDK, sem integrar API. Recebedores, split e Pagar.me já vêm no pacote.

Carta lacrada

O pedido inteiro viaja num token assinado.

Valor, itens, cliente e quem recebe vão dentro de um JWT assinado com o segredo da loja. Sem a chave, não existe checkout.

eyJhbGciOiJIUzI1NiJ9.eyJzdG9yZV9pZCI6….mj0-uju…

Anatomia do token

O notebook

Qualquer sistema assina. Sem SDK, sem integrar API.

Seu ERP, CMS, app ou um parceiro assina o token e redireciona o cliente. Se ele assina JWT, ele já integra.

NodePythonGoPHPRuby

Ver o código

Pix, cartão e boleto

O checkout hospedado cobra e confirma o pagamento.

O cliente paga numa página sua, na sua infraestrutura: cartão, Pix ou boleto. Você acompanha pedidos, estornos e recebedores no painel.

Pago · Pix · R$ 150,00 (exemplo)

Na sua infra

O mercado

Vários recebedores, uma venda: o split divide o valor.

Cada vendedor da sua praça é um recebedor. Com o seller_id no token, a venda é dividida entre a plataforma e quem recebe.

Recebedor · 90%Plataforma · 10%

Exemplo: taxa de 10% por venda.

Recebedores

Outros gateways

Pagar.me hoje. Os outros, por um contrato único.

Só o Pagar.me está integrado hoje. Woovi, Pague.dev, AbacatePay, CriptoPag e Hodle estão no roadmap e entram por um contrato único.

Pagar.me ✓WooviPague.devAbacatePayCriptoPagHodle

Ver os gateways

Fig. I — Holbein (1532) e Beuckelaer (1561), em colagemO notebook, a maquininha, o Pix e o bitcoin são licença poética.

I Como funciona

Um token no lugar de uma integração.

O pedido inteiro viaja dentro de um token assinado. Não há chamada de API do seu lado: só um redirecionamento.

  1. I Assine
    Cartas dobradas presas a uma prateleira, fechadas com selos de cera vermelha.
    Cartas lacradas · Holbein, 1532

    Seu sistema assina o pedido

    Sua loja, seu ERP ou um parceiro assina um JWT com o pedido: valor, itens, cliente e, se houver, quem recebe.

  2. II Redirecione
    Mão de um comerciante segurando uma carta dobrada sobre uma mesa coberta por um tapete.
    A carta na mão · Holbein, 1532

    O cliente abre o checkout

    O checkout hospedado abre em /pay?session_token=… O servidor confere a assinatura e cria o pedido uma única vez.

  3. III Receba
    Um prestamista pesa moedas de ouro numa pequena balança de mão.
    A pesagem · Massys, 1514

    O pagamento é dividido

    Pix, cartão ou boleto são cobrados pelo Pagar.me. Com um seller_id no token, a venda é dividida entre a plataforma e o recebedor.

import { SignJWT } from 'jose';
const secret = new TextEncoder().encode(process.env.ORDER_SECRET);

const token = await new SignJWT({
  store_id: 'MINHA_LOJA',
  seller_id: 'seller_123', // opcional: habilita o split
  external_id: 'PED_1042',
  idempotency_key: 'PED_1042_v1',
  customer: { email: '[email protected]', name: 'Ana Lima' },
  order: { amount: 15000, items: [{ desc: 'Plano anual', qty: 1, price: 15000 }] },
})
  .setProtectedHeader({ alg: 'HS256' })
  .setExpirationTime('30m')
  .sign(secret);

redirect(`https://checkout.suaempresa.com/pay?session_token=${token}`);
Resultado→ https://checkout.suaempresa.com/pay?session_token=eyJhbGciOiJIUzI1NiIs…

Se o seu sistema assina um JWT, ele já integra.

Ver todos os campos do token

II Anatomia do token

O pedido inteiro, num único token.

cabeçalho
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.
conteúdo
eyJzdG9yZV9pZCI6Ik1JTkhBX0xPSkEiLCJzZWxsZXJfaWQiOiJzZWxsZXJfMTIzIiwi….
assinatura
mj0-ujuQ0flLcHZriraYeifSohYuCMoEYG1XYffvLjU
  1. I

    De qual loja vem. Escolhe o segredo que valida a assinatura.

  2. II

    Opcional: o seu id do recebedor. Com ele, a venda é dividida.

  3. III

    O mesmo token nunca cobra duas vezes.

  4. IV

    Valor em centavos e itens do pedido.

  5. V

    Quem paga. Qualquer JSON, guardado junto com o pedido.

  6. VI

    Assinado com o segredo da loja. Sem a chave, não existe checkout.

Fig. II — Anatomia de um token de checkout

O prestamista e sua mulher, de Quentin Massys (1514): ele pesa moedas de ouro numa balança de mão enquanto ela folheia um livro.
Fig. III — Quentin Massys, O prestamista e sua mulher, 1514

Split · exemplo

R$ 150,00

Recebedor · 90%
R$ 135,00
Plataforma · 10%
R$ 15,00

Convite · válido por 7 dias

/onboarding?token=eyJhbGciOiJIUzI1NiIs…

III Recebedores

Quem recebe, recebe certo.

Marketplace e plataforma de parceiros precisam saber quem recebe quanto, sem cada vendedor virar uma integração. O cadastro é um link; o split é uma linha do token.

  1. I

    Convite. Você gera um link assinado no painel. Ele vale por 7 dias.

  2. II

    Cadastro. O recebedor preenche quatro passos e é registrado no gateway. O status aparece no seu painel.

  3. III

    Split. Com o seller_id no token, a venda é dividida pela taxa configurada do recebedor, percentual ou fixa.

Como funciona o onboarding

IV Gateways

Um gateway hoje. Os outros, por um contrato único.

Gateway

Estado

  • Pagar.me

    Cartão, Pix e boleto · API v5 · recebedores e split

    Disponível
  • Woovi

    Em breve
  • Pague.dev

    Em breve
  • AbacatePay

    Em breve
  • CriptoPag

    Em breve
  • Hodle

    Em breve

Pagar.me v5 é o único gateway integrado hoje. Os próximos entram por um contrato único, a interface Provider (ProcessPayment e RegisterSeller). É roadmap, sem data.

Seu sistema

assina o token

CheckoutPP

valida, cobra, divide

Provider · contrato

ProcessPayment · RegisterSeller

  • Pagar.meintegrado hoje
  • Woovi
  • Pague.dev
  • AbacatePay
  • CriptoPag
  • Hodle
Ver o contrato Provider

V Alfaiataria

Um checkout sob medida.

Escolha o tecido, a linha, o corte e a letra. O checkout hospedado veste a sua marca, e você vê o resultado antes de salvar.

O alfaiate, de Giovanni Battista Moroni (c. 1570): um homem de camisa clara e calções vermelhos, a tesoura numa mão e a outra pousada sobre um tecido preto, em cima da mesa.

Tecido nº 7

Petróleo

#0f5c63

Fig. V — Moroni, O alfaiate, c. 1570

Tecido · a cor da marca

Linha · o destaque

Corte · os cantos

Letra · a tipografia

Isto é uma demonstração: nada é salvo. No painel, Alfaiataria guarda a sua escolha, e o próximo checkout aberto já a usa.

  1. I

    Nome e logo no recibo. O nome da loja e o logo (por https) ficam no alto do recibo, no lugar do identificador.

  2. II

    Contraste sempre à vista. Se uma cor ficar pálida demais no papel claro ou no escuro, ajustamos o tom para ela continuar legível.

  3. III

    Vale no próximo checkout. Salve no painel e o próximo checkout aberto já usa o tema. Sem deploy, sem mexer em código.

VI Na sua infraestrutura

Seu checkout, seu domínio, seu banco.

Um binário
Go, com a interface web embutida.
Banco
PostgreSQL.
Orquestração
Temporal, opcional. Sem ele, os pagamentos rodam de forma síncrona.
Deploy
docker compose up, ou Railway em um clique.
Taxa
Nenhuma da plataforma: você paga só o gateway.
Painel administrativo do CheckoutPP, tema claro: volume, taxas, take rate, vendedores ativos e o gráfico de volume diário.
Fig. IV — Painel administrativo (dados de demonstração)

docker compose up

Sobe o PostgreSQL e o app, roda as migrações e abre em localhost:8091.

O livro-razão

Cada centavo, de onde veio e para onde vai.

Quando a venda é dividida, os dois lados ficam registrados — a mesma ideia das partidas dobradas que Luca Pacioli descreveu em 1494.

Luca Pacioli, retratado por Jacopo de' Barbari por volta de 1495: um frade franciscano com um compasso sobre uma lousa de geometria, ao lado de um poliedro de vidro e de um jovem aluno.

Fig. V — Jacopo de' Barbari, Luca Pacioli e um aluno, c. 1495