Aesesdocs

Inicio rápido

Esta guía te muestra los cuatro pasos necesarios para empezar a aceptar pagos en cripto con Aeses: crear una API key, consultar tus saldos, generar una dirección de depósito y verificar un webhook entrante. Al final, estarás listo para integrar en producción.

1. Crear una API key

Inicia sesión en el Panel Aeses y abre Developers → API keys. Crea una nueva clave en modo de prueba para desarrollo. El modo de prueba usa redes públicas de testnet (Sepolia, Bitcoin testnet, Tron Nile, Solana devnet) y nunca mueve fondos reales.

Tu clave secreta tiene el formato sk_live_4eC39HqLyjWDarjtT1zdp7dc. Guárdala en una variable de entorno — nunca la subas al control de versiones ni la expongas en un navegador.

Trata las claves secretas como contraseñas

Cualquiera con tu clave secreta puede autorizar transferencias y ver todos los datos de tu cuenta. Rótala de inmediato si se expone.

2. Listar tus saldos

Cada cuenta Aeses tiene un libro mayor interno de saldos por activo. Lístalos para confirmar que la clave funciona.

Solicitud
curl https://api.aeses.io/v1/balances \
-H "x-api-key: sk_live_4eC39HqLyjWDarjtT1zdp7dc"

Una cuenta nueva devuelve un array data vacío. Tras recibir tu primer depósito, el saldo correspondiente aparece aquí.

3. Crear un depósito

Genera una dirección de un solo uso para que el cliente envíe los fondos. Aeses deriva la dirección desde una HD wallet endurecida — nunca manejas claves privadas.

Solicitud
curl https://api.aeses.io/v1/deposits \
-H "x-api-key: sk_live_4eC39HqLyjWDarjtT1zdp7dc" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
  "asset": "USDT",
  "chain": "ethereum",
  "amount": "10.00",
  "webhook_url": "https://example.com/webhooks/aeses"
}'

La respuesta contiene un address nuevo válido durante 30 minutos:

Respuesta
{
"id": "dep_01HXYZ7M2P5RT4VG3K8AQWE9FN",
"object": "deposit",
"status": "pending",
"asset": "USDT",
"chain": "ethereum",
"address": "0x8f3a9c2bF7e1A4d62D8b9fF6E3c5a7E1d2B4c8A9",
"expected_amount": "10.00",
"expires_at": 1731600000
}

Envía al cliente a la dirección. En testnet, puedes financiarla desde un faucet.

4. Recibir y verificar el webhook

Cuando el depósito alcanza las confirmaciones requeridas, Aeses hace un POST del evento deposit.completed a la webhook_url. Cada webhook lleva un header X-Webhook-Signature que debes verificar antes de confiar en el payload — consulta Firmas de webhook para el algoritmo completo.

Probar el webhook localmente
# Reenvía webhooks del panel a tu servidor local
ngrok http 3000

# Actualiza webhook_url en la solicitud de depósito a la URL de ngrok

# Dispara un evento de prueba en Developers → Webhooks → Enviar evento de prueba

Una vez recibido y verificado el evento, acredita el pedido del cliente en tu propio sistema y devuelve 200 OK.

Siguientes pasos