Início Rápido
Este guia vai te ajudar a fazer sua primeira integração com a API da Pronttus em menos de 5 minutos.
Crie sua conta
Acesse app.pronttus.com.br/register e crie sua conta gratuitamente.Você precisará fornecer:
- E-mail corporativo
- CNPJ da empresa
- Dados do representante legal
Obtenha suas credenciais
Após criar sua conta, acesse a seção “Desenvolvedor” no dashboard e gere suas credenciais de API:{
"client_id": "seu_client_id",
"client_secret": "seu_client_secret"
}
Mantenha suas credenciais em segurança. Nunca compartilhe ou exponha em repositórios públicos.
Obtenha seu token de acesso
Use suas credenciais para gerar um token de autenticação:curl -X POST https://api.pronttus.com.br/v1/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "client_credentials",
"client_id": "seu_client_id",
"client_secret": "seu_client_secret"
}'
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "bearer",
"expires_in": 300
}
Faça sua primeira requisição
Agora você está pronto para criar seu primeiro QR Code PIX:curl -X POST https://api.pronttus.com.br/v1/banking/cash-in/pix \
-H "Content-Type: application/json" \
-H "Authorization: Bearer seu_access_token" \
-d '{
"amount": 10000,
"description": "Teste de integração",
"customer": {
"name": "João Silva",
"email": "[email protected]",
"document": "12345678900",
"phone": "19999999999"
}
}'
O valor do amount é em centavos. Exemplo: R$ 100,00 = 10000
Exemplo de Integração Completa
Aqui está um exemplo completo em Javascript:
const axios = require('axios');
const BASE_URL = 'https://api.pronttus.com.br/v1';
// 1. Obter token de autenticação
async function getAuthToken() {
const response = await axios.post(`${BASE_URL}/oauth/token`, {
grant_type: 'client_credentials',
client_id: 'seu_client_id',
client_secret: 'seu_client_secret'
});
return response.data.access_token;
}
// 2. Criar QR Code PIX
async function createPixQRCode(token) {
const response = await axios.post(
`${BASE_URL}/banking/cash-in/pix`,
{
amount: 10000, // R$ 100,00
description: 'Pagamento de serviço',
customer: {
name: 'João Silva',
email: '[email protected]',
document: '12345678900',
phone: '19999999999'
}
},
{
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
}
}
);
return response.data;
}
// Executar
async function main() {
try {
const token = await getAuthToken();
const qrcode = await createPixQRCode(token);
console.log('QR Code criado com sucesso!');
console.log('Código PIX:', qrcode.data.qrcode);
} catch (error) {
console.error('Erro:', error.response?.data || error.message);
}
}
main();
Testando a Integração
Use ferramentas como Postman ou Insomnia para testar os endpoints antes de implementar no código.
Checklist de Integração
Conta criada no dashboard
Credenciais de API geradas
Token de autenticação obtido com sucesso
Primeira requisição realizada
Webhook configurado (opcional, mas recomendado)
Próximos Passos
Agora que você completou a configuração inicial, explore mais funcionalidades:
Suporte
Encontrou algum problema? Estamos aqui para ajudar:
- E-mail: [email protected]
- WhatsApp: +55 (11) 99999-9999
- Horário: Segunda a Sexta, 9h às 18h (BRT)
