# Recibir pagos en Ethereum (ETH)

> Recibe Ethereum (ETH) con CryptoLike: una dirección 0x nueva por pago, página de pago alojada, acreditación tras las confirmaciones y un webhook firmado.

Source: https://cryptolike.net/es/coins/ethereum
Updated: 2026-10-04

CryptoLike acredita un pago en Ethereum en tu saldo tras 12 confirmaciones de la red Ethereum y lo notifica a tu servidor con un webhook firmado. Tú creas el pago; el cliente envía ETH desde su propia billetera a una dirección nueva; CryptoLike vigila la dirección, cuenta las confirmaciones y cambia el estado de `pending` a `paid`. Mientras el pago está en `pending`, una reorganización de bloques todavía puede descartar la transferencia, así que entrega el pedido con `paid`; el artículo [por qué «detectado» no es «pagado»](https://cryptolike.net/es/blog/blockchain-reorg-explained) explica qué pasa en ese caso.

## Cómo funciona un pago en Ethereum

Un pago en Ethereum en CryptoLike pasa por cuatro pasos y tres estados: `new` (Nuevo), `pending` (Pendiente) y `paid` (Pagado). La página de pago, la API y los webhooks muestran el mismo estado, así que la lógica de tus pedidos lee un solo campo. El cliente no necesita una cuenta en CryptoLike, solo una billetera Ethereum con ETH suficiente para el monto y el gas.

1. **Creas el pago** con `POST /v1/invoices`, el [plugin para WooCommerce](https://cryptolike.net/es/integrations/woocommerce), el [módulo para Magento 2](https://cryptolike.net/es/integrations/magento) o un [enlace de pago](https://cryptolike.net/es/use-cases/payment-links). Estado: `new`.
2. **El cliente ve qué enviar:** el monto exacto en ETH, la red (Ethereum), la dirección con código QR y el tiempo restante.
3. **Se detecta la transferencia.** Estado: `pending`, «Pago detectado. Esperando confirmación.»
4. **El pago se confirma.** Tras 12 confirmaciones el estado pasa a `paid`, los fondos están en tu saldo y llega un [webhook](https://cryptolike.net/docs/webhooks) `invoice.paid` firmado.

## Lo que el cliente debe saber sobre Ethereum

CryptoLike asigna a cada pago en Ethereum su propia dirección, que empieza por `0x` y nunca se reutiliza. La billetera del cliente paga la comisión de red, llamada gas, en ETH además del monto. CryptoLike detecta una transferencia directa de ETH desde una billetera normal; el ETH que mueve un contrato inteligente, como hacen algunas billeteras de contrato y los retiros agrupados de los exchanges, no se detecta automáticamente.

- **Dirección.** `0x` seguido de 40 caracteres hexadecimales. Otras redes compatibles con EVM usan el mismo formato, así que revisa el nombre de la red en la página, no solo la dirección.
- **Comisión de red.** El gas se paga en ETH y cambia con la carga de la red; la billetera lo muestra antes de enviar.
- **Solo cuenta ETH.** Un pago en ETH se paga en ETH. Para pagar en USDT o USDC, el cliente necesita un pago en [USDT (ERC20)](https://cryptolike.net/es/coins/usdt-erc20) o en [USDC (ERC20)](https://cryptolike.net/es/coins/usdc-erc20).
- **Monto exacto.** Si un exchange descuenta su comisión de retiro, el pago llega incompleto y queda en `underpaid` (Pago insuficiente). Envía la diferencia a la misma dirección antes de que se acabe el tiempo.
- **Red.** El ETH enviado por otra red nunca llega al pago y no se puede recuperar.

## Crea un pago en Ethereum

Para crear un pago en Ethereum en CryptoLike, toma el `id` del activo con `ticker` ETH y `network` eth de `GET /v1/currencies` y pásalo como `coin_id` a `POST /v1/invoices`. Pon el precio en ETH, como en el ejemplo, o en USD o EUR: en ese caso CryptoLike convierte al tipo de cambio actual y lo deja fijado durante el plazo del pago.

```bash
COIN_ID=$(curl -s https://api.cryptolike.net/v1/currencies \
  | jq -r '.currencies[] | select(.ticker=="ETH" and .network=="eth") | .id')

BODY='{"amount":"0.05","currency":"ETH","coin_id":"'"$COIN_ID"'","order_id":"A-1005"}'
curl -s https://api.cryptolike.net/v1/invoices \
  -H "Content-Type: application/json" -H "Idempotency-Key: order-A-1005" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" -d "$BODY"
```

La respuesta trae `address`, `payer_amount` y `checkout_url`: envía al cliente a esa página. Firma de las solicitudes: [autenticación de la API](https://cryptolike.net/docs/auth); todos los campos: [referencia de la API](https://cryptolike.net/docs/api).

## Preguntas frecuentes

### ¿Cuántas confirmaciones necesita un pago en Ethereum?

CryptoLike acredita ETH tras 12 confirmaciones de la red Ethereum. El umbral se define para cada activo, lo devuelve `GET /v1/currencies` y el cliente ve el avance en la página de pago. Más información sobre las [confirmaciones](https://cryptolike.net/es/glossary/confirmations).

### ¿Qué pasa si el cliente envía ETH por otra red?

La transferencia no llega a este pago y no se puede recuperar: un pago en Ethereum vigila su dirección solo en la red principal de Ethereum. Si el tiempo ya se acabó, crea un pago nuevo.

### ¿Qué pasa si el cliente paga desde una billetera de contrato inteligente?

Una transferencia hecha por un contrato inteligente no se detecta automáticamente, así que el estado sigue en `new`. Pide al cliente que envíe desde una dirección de billetera normal. Si ya se hizo una transferencia desde un contrato, escribe a soporte con el identificador de la transacción.

### ¿Puedo poner el precio en USD?

Sí. Envía `currency: "USD"` con el `coin_id` de ETH: CryptoLike convierte al tipo de cambio actual y lo deja fijado durante el plazo del pago. Si no hay un tipo de cambio reciente, la API responde `503`: reintenta o pon el precio del pago en ETH.

### ¿Cómo funcionan los retiros en Ethereum?

Con `POST /v1/withdrawals` y los campos `coin_id`, `amount`, `to_address` y tu `payout_id`, o con un CSV de hasta 1,000 filas en el panel ([pagos masivos](https://cryptolike.net/es/use-cases/mass-payouts)). Antes, `POST /v1/withdrawals/estimate` muestra la comisión de la plataforma, la comisión de red reservada y el total a debitar. Los retiros requieren una cuenta verificada; las comisiones están en la página de [precios](https://cryptolike.net/es/pricing).