Como Integrar Cripto no Seu Sistema com a Aeses

Fazer a integração cripto do seu produto com a Aeses é um processo direto. Em aeses.io você cria a conta, gera as chaves de API e, com poucas chamadas, já consegue gerar cobranças e receber pagamentos em cripto com conversão automática para stablecoin. Este passo a passo mostra o caminho do zero à primeira cobrança confirmada.

1. Crie sua conta e gere as chaves

Acesse aeses.io, abra sua conta e vá até a área de desenvolvedores para gerar suas chaves de API. Você terá uma chave de teste (sk_test_) para o sandbox e uma de produção (sk_live_). A chave secreta vive apenas no seu servidor, nunca no front-end.

2. Crie uma cobrança pela API da Aeses

Uma cobrança representa um valor a receber. Você informa o valor, a moeda e a rede, e a Aeses devolve um endereço de pagamento efêmero com prazo de expiração.

curl https://api.aeses.io/v1/charges \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "199.90",
    "currency": "USDT",
    "network": "polygon",
    "reference": "assinatura_5521",
    "settlement": "stablecoin"
  }'

3. Receba o status via webhook

Configure um endpoint de webhook em aeses.io. A Aeses envia um POST assinado quando o status da cobrança muda. Valide a assinatura e processe de forma idempotente para lidar com entregas duplicadas.

import { createHmac, timingSafeEqual } from 'crypto'

export function handleAesesWebhook(rawBody: string, signature: string) {
  const secret = process.env.AESES_WEBHOOK_SECRET!
  const expected = createHmac('sha256', secret).update(rawBody).digest('hex')
  if (expected.length !== signature.length ||
      !timingSafeEqual(Buffer.from(expected), Buffer.from(signature))) {
    throw new Error('assinatura inválida')
  }

  const event = JSON.parse(rawBody)
  if (event.type === 'charge.confirmed') {
    // libere o pedido, idempotente pelo event.id
    liberarPedido(event.data.reference, event.id)
  }
}

4. Vá para produção

1. Troque as chaves de teste pelas de produção (sk_live_).
2. Aponte o webhook de produção e valide a assinatura.
3. Garanta idempotência: registre o event.id antes de aplicar o efeito.
4. Acompanhe as cobranças e eventos no painel da Aeses.