Integre pagamentos PIX e cartao na sua aplicacao em minutos. Uma API REST moderna, com autenticacao JWT, webhooks em tempo real e suporte a multiplos provedores.
Gere cobranças PIX com QR code dinâmico e receba confirmação em tempo real via webhook.
Processe cobranças em cartão de crédito com tokenização segura e captura automática.
Receba notificações instantâneas sobre mudanças de status em cobranças e pagamentos.
Conecte Asaas, Mercado Pago e outros provedores sob uma API unificada.
120 req/min por usuario, headers padrao X-RateLimit-* em todas as respostas.
Toda requisicao autenticada requer um token JWT no header Authorization: Bearer <token>.
Registre-se ou receba um convite. Suas credenciais sao email + senha.
Envie POST /auth/login com email e senha. Receba um token JWT valido.
Passe o JWT em Authorization: Bearer <token> em todas as chamadas protegidas.
curl -X POST http://localhost:8080/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"user@empresa.com","senha":"sua-senha"}'
# Response
{
"token": "eyJhbGciOiJIUzI1NiIs...",
"type": "Bearer"
}Visao geral dos grupos de endpoints disponiveis na API.
Autenticacao via JWT — login e troca de API key por token.
CRUD de clientes vinculados a uma conta. Suporte a externalId para correlacao com seu sistema. Listagem com respostas paginadas.
Criar cobranças PIX e cartão, consultar status, estornar. Suporte a externalId para rastreio. Listagem com respostas paginadas.
Gerenciar conexões com provedores de pagamento (Asaas, MercadoPago). Listagem com respostas paginadas.
Receber e verificar notificações dos provedores.
Gerenciar contas e configurações da operação.
Autentique e crie sua primeira cobranca PIX em dois passos.
# 1. Autentique e obtenha um JWT
curl -s -X POST http://localhost:8080/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"user@empresa.com","senha":"sua-senha"}' \
| jq -r '.token'
# 2. Crie uma cobrança PIX
curl -X POST http://localhost:8080/api/v1/flashpays/asaas/pix \
-H "Authorization: Bearer <JWT>" \
-H "Content-Type: application/json" \
-d '{
"customer": "cus_abc123",
"billingType": "PIX",
"value": 49.90,
"description": "Pedido #1042",
"externalId": "ORDER-123"
}'
# Respostas de listagem retornam envelope paginado:
# {
# "data": [{ ... }, { ... }],
# "pagination": {
# "limit": 50, "offset": 0, "count": 12, "hasMore": false
# }
# }Integre mais rapido com SDKs prontos para producao.
Crie sua conta, conecte um provedor e comece a processar pagamentos em minutos.