Recibir pagos en Ethereum (ETH)

#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, el módulo para Magento 2 o un enlace de pago. 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 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) o en 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.

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; todos los campos: referencia de la 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.

#¿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). 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.