Recibir pagos en Litecoin (LTC)

#Cómo funciona un pago en Litecoin

Un pago en Litecoin 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 Litecoin que pueda enviar a una dirección ltc1.

1. Creas el pago con POST /v1/invoices, el plugin para WooCommerce, el módulo para PrestaShop o un enlace de pago. Estado: new.
2. El cliente ve qué enviar: el monto exacto en LTC, la red (Litecoin), 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 6 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 Litecoin

CryptoLike asigna a cada pago en Litecoin su propia dirección SegWit nativa, que empieza por ltc1q y nunca se reutiliza. La billetera del cliente suma la comisión de red de Litecoin en LTC al monto, y el monto de la página de pago tiene que llegar completo. Solo el LTC nativo en la red Litecoin llega al pago.

• Dirección. En minúsculas, empieza por ltc1q y sirve solo para este pago.
• Comisión de red. La fija la billetera del remitente y se paga en LTC, aparte del monto.
• Monto exacto. Si una billetera o un exchange descuenta su comisión del monto, 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.
• Transferencias tardías. Una transferencia confirmada después de que el pago venció se acredita igualmente en tu saldo, marcada con late_payment: true y con un webhook invoice.late_payment. Acuerda con el cliente si entregas el pedido o le reembolsas.
• Red. Envía LTC solo en la red Litecoin. Los fondos enviados por otra red nunca llegan al pago y no se pueden recuperar.

#Crea un pago en Litecoin

Para crear un pago en Litecoin en CryptoLike, toma el id del activo con ticker LTC y network ltc de GET /v1/currencies y pásalo como coin_id a POST /v1/invoices. Pon el precio en USD, como en el ejemplo, o en LTC; un monto en moneda fiat se convierte al tipo de cambio actual, que queda fijado durante el plazo del pago.

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

BODY='{"amount":"19.00","currency":"USD","coin_id":"'"$COIN_ID"'","order_id":"A-1004"}'
curl -s https://api.cryptolike.net/v1/invoices \
  -H "Content-Type: application/json" -H "Idempotency-Key: order-A-1004" \
  -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 Litecoin?

CryptoLike acredita LTC tras 6 confirmaciones de la red Litecoin. 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 LTC por otra red?

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

#¿Puedo poner el precio en USD?

Sí. Envía currency: "USD" con el coin_id de LTC: 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 LTC.

#¿Un cliente puede tener una dirección de Litecoin permanente?

Sí. POST /v1/addresses con el coin_id de LTC y tu customer_id emite una dirección estática. Cada transferencia a ella se acredita tras 6 confirmaciones y se notifica con deposit.confirmed (si la transferencia queda retenida para revisión, llega deposit.on_hold), lo que encaja con las recargas de saldo.

#¿Cómo funcionan los retiros en Litecoin?

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). Las direcciones de destino pueden empezar por L, M o ltc1; las direcciones Litecoin antiguas que empiezan por 3… se rechazan, así que pide al destinatario una dirección M… o ltc1. 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.