100PRATAS | API Documentation

Stable_v1.0.0 REST_API JSON_ONLY

Introdução_

Bem-vindo à documentação oficial da 100Pratas. Nossa API foi construída sob o princípio de "Simplicidade Radical". Focamos exclusivamente em micro-pagamentos de até R$ 100,00 via Pix.

Todos os endpoints da área logada exigem o header:
Authorization: Bearer <seu_token>

Core_Engine_

Infraestrutura de checkout, webhooks e liquidação.

Resolução de Checkout

GET /v1/core/resolve-link/:id

Criar Transação PIX

POST /v1/core/transactions

{
  "link_id": "uuid",
  "customer_email": "cliente@email.com",
  "channel": "web" | "whatsapp"
}
            

Status da Transação (Polling)

GET /v1/core/transactions/:id/status

Liquidação (Internal Payout)

POST /v1/core/internal/payouts/execute

Dashboard_Overview_

Métricas consolidadas para o painel administrativo.

GET /v1/dashboard/overview

{
  "metrics": {
    "total_volume": 15430.20,
    "today_sales_count": 12,
    "active_links_count": 8
  },
  "sales_history": [...],
  "recent_transactions": [...]
}
            

Gestão_de_Links_

Criação e controle de links de pagamento Pix.

Criar Link (Limite R$ 100,00)

POST /v1/links

{
  "name": "E-book Produtividade",
  "price": 49.90
}
            

Listar Meus Links

GET /v1/links

Alternar Status

PATCH /v1/links/:id/toggle-status

Transações_

Histórico detalhado de vendas e exportação.

Listar e Filtrar

GET /v1/transactions?page=1&limit=10

Exportar CSV

GET /v1/transactions/export

WhatsApp_Business_

Integração para checkout via chat.

Enviar Link

POST /v1/whatsapp/send-link

{
  "phone": "5511987654321",
  "link_id": "uuid",
  "custom_message": "Olá! Segue seu link."
}
            

Configurações_Me_

Ajustes de perfil, segurança e integrações.

Chave Pix de Recebimento

PUT /v1/me/pix-key

Webhook e API Key

PUT /v1/me/webhook

POST /v1/me/api-key/rotate

Perfil e Notificações

PATCH /v1/me/profile

PUT /v1/me/notifications

Autenticação_

Login (2 Etapas)

1. Inicie com POST /v1/auth/login para receber o código por email.

2. Valide com POST /v1/auth/login/2fa para obter o JWT final.

Endpoints_Públicos_

GET /v1/public/stats

GET /v1/public/config