# Factura cripto

> Una solicitud de cobro única por un monto fijo, con plazo y página de pago propia. Cómo se crea, se cotiza, se paga y se reporta una factura en CryptoLike.

Source: https://cryptolike.net/es/glossary/crypto-invoice
Updated: 2026-10-04

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](https://cryptolike.net/glossary/rate-lock). 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](https://cryptolike.net/glossary/payment-link). `GET /v1/invoices?format=csv` o `?format=xlsx` exporta la lista. Paso a paso: [crear una factura cripto](https://cryptolike.net/guides/create-crypto-invoice).

## 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:

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