Guia de Início Rápido
Integre a API Atlas em sua aplicação em poucos minutos. Este guia mostra como criar seu primeiro link de pagamento PIX.
1. Configuração da API
Base URL (Produção):
https://api.atlasdao.info/api/v12. Criar Link de Pagamento
// Criar link de pagamento
const response = await fetch('https://api.atlasdao.info/api/v1/external/payment-links', {
method: 'POST',
headers: {
'X-API-Key': 'SUA_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Produto Exemplo',
description: 'Descrição do produto',
amount: 99.90,
walletAddress: 'your_wallet_address_here'
})
});
const paymentLink = await response.json();
console.log('Link:', paymentLink.paymentUrl);3. Gerar QR Code PIX
// Gerar QR Code PIX com webhook configurado
const response = await fetch('https://api.atlasdao.info/api/v1/external/pix/create', {
method: 'POST',
headers: {
'X-API-Key': 'SUA_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 99.90,
description: 'Pagamento teste',
depixAddress: 'your_wallet_address_here', // opcional - se omitido, cria transação sem QR
taxNumber: '12345678900', // opcional para valores < R$ 3000
merchantOrderId: 'ORDER-123', // opcional
// NOVO: Configuração de webhook
webhook: {
url: 'https://meusite.com/webhook',
events: [
'transaction.created', // Quando PIX é gerado
'transaction.paid', // Quando pagamento é confirmado
'transaction.failed', // Quando pagamento falha
'transaction.expired' // Quando PIX expira
],
secret: 'minha-chave-secreta-min-16-chars', // opcional (min 16 caracteres)
headers: { // Headers customizados (opcional)
'X-Custom-Header': 'valor'
}
}
})
});
const pixData = await response.json();
// Resposta inclui QR code e webhook info:
// { id, status, amount, qrCode, qrCodeImage, expiresAt, webhook: { id, url, events, secretHint } }
console.log('QR Code:', pixData.qrCode);
console.log('Webhook ID:', pixData.webhook?.id);