API REST v1

Documentación

Autenticación con Authorization: Bearer pk_inv_… para cobrar y pk_wdr_… para retirar. La llave se muestra una sola vez.

Crear factura

curl -X POST https://criptonymus.xyz/api/v1/invoices \
  -H "Authorization: Bearer pk_inv_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1001" \
  -d '{
    "orderNumber": "1001",
    "asset": "USDT_TRC20",
    "amount": "25.00",
    "feePayer": "merchant"
  }'

Monedas: BTC, ETH, TRX, SOL, USDT ERC-20 y USDT TRC-20. La comisión actual es 0,5 %. Si la paga el cliente, se suma al monto a transferir. La base de la API es https://criptonymus.xyz/api.

Avisos

Criptonymus hace POST a tu callbackUrl con el cuerpo JSON del evento. La firma es HMAC-SHA256 de timestamp.eventId.cuerpo, con el secreto de la cuenta. Revisa X-Signature (sha256= y el hex), X-Timestamp (segundos unix) y X-Event-Id. Rechaza avisos con más de 5 minutos de diferencia y guarda el id del evento para no procesarlo dos veces.

Eventos: invoice.pending, invoice.completed, invoice.underpaid, invoice.overpaid, invoice.expired y withdrawal.completed.

Otros recursos

• GET /v1/currencies
• GET /v1/balances
• GET /v1/invoices/:id
• POST /v1/withdrawals con la llave de retiro, hacia una dirección de la lista permitida