Factura cripto

Una solicitud de cobro única por un monto fijo, con precio en cripto o en fiat, con un plazo límite y con su propia página de pago y dirección de depósito.

#Cómo funciona en CryptoLike

En CryptoLike una factura es un pago: POST /v1/invoices con amount y currency, que puede ser un código fiat (USD, EUR) o el ticker de una moneda (BTC, USDT). La respuesta trae id, status: new, checkout_url y ttl_expires_at. Pasa coin_id para fijar el activo desde el inicio, o no lo envíes y deja que el pagador elija en la página de pago, donde un precio en fiat recibe un tipo de cambio fijado. El pagador elige entre las monedas disponibles para facturas (Monedas → Para facturas en el panel), cada una con un monto aproximado marcado con ≈; allowed_coin_ids limita la lista para una factura.

Después, el estado avanza new → pending → paid; también puede terminar en underpaid, expired o cancelled (POST /v1/invoices/{id}/cancel, solo desde new). Cada cambio llega como un webhook invoice.*. order_id, description y metadata (hasta 20 pares de cadenas, 4 KB como máximo, nunca visibles para el pagador) vinculan el pago con tu pedido; idempotency_by_order_id: true devuelve el pago abierto del mismo pedido en lugar de crear otro.

Sin código, crea un pago en el panel —monto en fiat o en cripto, tiempo para pagar, URL de retorno, quién paga la comisión de la plataforma— o en el bot de Telegram, y luego comparte su enlace de pago. GET /v1/invoices?format=csv o ?format=xlsx exporta la lista. Paso a paso: crear una factura cripto.

#Ejemplo

La solicitud de factura más simple de CryptoLike solo necesita un monto y una moneda; order_id la vincula con tu pedido y return_url es el enlace «volver a la tienda» que se muestra después del pago. Envíala con un encabezado Idempotency-Key para que un reintento nunca cree una segunda factura:

{
  "amount": "10.50",
  "currency": "USD",
  "order_id": "A-1001",
  "return_url": "https://shop.example/thanks"
}