POST/v1/deposits

Crear un depósito

Crea una nueva intención de depósito. La respuesta incluye una dirección de un solo uso recién generada en la chain solicitada. Los fondos enviados a esa dirección se acreditan al saldo interno del comercio para el activo correspondiente.

Envía siempre una Idempotency-Key para que los reintentos sean seguros. El cuerpo de la solicitud debe ser JSON (Content-Type: application/json).

Parámetros

stringRequired

Activo a recibir. Debe ser uno de ETH, USDT, BTC, TRX.

stringRequired

Familia de chain. Debe ser una de ethereum, tron, bitcoin, y compatible con asset.

stringOptional

Monto esperado opcional, como string decimal con hasta 8 decimales. Cuando se proporciona, el depósito se marca como underpaid o overpaid según el monto realmente recibido.

stringOptional

Tu propio identificador para este depósito (p. ej. ID de pedido). 1–255 chars. Se devuelve en todos los webhooks relacionados.

stringOptional

URL de webhook por depósito (http(s), máx 2000 chars). Sobrescribe los endpoints de webhook de la cuenta para eventos de este depósito.

stringOptional

Timestamp ISO-8601 en el que se cierra la ventana de la dirección de depósito. Si se omite, se usa la ventana por defecto de 30 minutos.

objectOptional

Pares clave/valor libres devueltos en el objeto deposit y en todos los webhooks relacionados.

Devuelve

Devuelve el objeto Deposit creado con status: "pending".

Errores

Status	Code	Description
400	`invalid_request_error`	Parámetro ausente, inválido, o combinación `asset`/`chain` no soportada.
401	`authentication_error`	Clave API ausente o inválida.
409	`idempotency_key_reused`	La `Idempotency-Key` se usó antes con un cuerpo de solicitud distinto.

Crear un depósito

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

Response

{
"object": "deposit",
"id": "dep_01hxyz7m2p5rt4vg3k8aqwe9fn",
"status": "pending",
"asset": "USDT",
"chain": "ethereum",
"expected_amount": "99.50",
"received_amount": null,
"deposit_address": "0x8f3a9c2bF7e1A4d62D8b9fF6E3c5a7E1d2B4c8A9",
"reference_id": "ord_4421",
"webhook_url": "https://example.com/webhooks/aeses",
"metadata": null,
"tx_hash": null,
"confirmations": 0,
"expires_at": 1731600000,
"created_at": 1731598200
}