Visão geral

Integre sua plataforma ao checkout do PrincipiaPay para vender com as soluções financeiras da Principia.

A API do PrincipiaPay permite que plataformas e parceiros criem checkouts (vendas) para seus alunos, recebam em tempo real o que acontece com cada venda e consultem cadastros, recebimentos e movimentações.

Os 3 passos da integração

1. Validar o token e configurar webhooks

Confira seu Api-Token com GET /seller e cadastre a URL que vai receber os eventos.

2. Criar um checkout

Crie a venda com POST /sales e redirecione o comprador para a URL devolvida.

3. Receber eventos de webhook

Acompanhe carrinho abandonado, pagamento, compra confirmada e cancelamento.

Rotas da API

Todas as rotas, com exemplos e playground.

Skill para agentes de IA

Baixe o SKILL.md para o seu agente (Claude, Cursor) integrar com esta API.

O que dá para fazer com a API

Vendas: criar checkouts, consultar vendas pelo seu ID ou pelo nosso, listar vendas e criar vendas exclusivas.
Webhooks: configurar URLs e eventos, testar o recebimento e alterar ou excluir configurações.
Cadastro do parceiro: validar o token e conferir seus dados.
Cursos, turmas e campanhas: manter o catálogo que aparece no checkout.
Recebimentos e financeiro: consultar recebimentos por venda e movimentações financeiras.

Base URL

As rotas ficam em https://app.principia.services/checkout/v4 (produção) e https://app-staging.principia.services/checkout/v4 (homologação). Veja Ambientes.

Suporte

Dúvidas, sugestões ou problemas: escreva para suporte-tecnologia@provi.com.br. Você também pode usar o botão Perguntar à IA, que responde com base nesta documentação.