Cobrar en cripto con CoinPayments

Con CoinPayments conectado, el enlace de pago de una reserva le deja al turista pagar con la criptomoneda que tenga, y el dinero entra directo a tu cuenta de CoinPayments. Tours Tico no cobra ni retiene nada; CoinPayments descuenta su propia comisión.

Antes de empezar: tres cosas que no son como con tarjeta

Esto no es un detalle técnico, es lo que cambia tu operación. Léelo antes de conectar.

1. La plata te queda en cripto. El cobro entra a tu balance de CoinPayments en la moneda que pagó el turista (o en la que hayas configurado la conversión). No se deposita en un banco de Costa Rica: para tenerlo en colones hay que sacarlo por fuera, y eso lo resolvés vos. Tours Tico te muestra la reserva en dólares, que es lo que el turista debía.
2. Las devoluciones NO se piden desde el panel. En cripto no existe el «devolver» que sí tiene una tarjeta: hay que transferir desde tu wallet a una wallet que el cliente te dé. Tours Tico te deja anotar esa devolución en la reserva (más abajo), pero la transferencia la hacés vos.
3. Cobrar de verdad exige la verificación del negocio (KYB) aprobada en CoinPayments. Sin eso podés probar, pero no cobrar. La verificación la hacen ellos y lleva su tiempo, así que conviene empezarla antes de necesitarla.

1. Sacar las credenciales

Ruta en CoinPayments: iniciá sesión en a-dashboard.coinpayments.net con la cuenta del negocio.

1. Andá a Integrations → Add Integration → API Integrations.
2. Poné un nombre y la Store URL de tu sitio. Las dos son obligatorias.
3. Dejá los permisos como vienen y guardá.
4. Copiá el Client ID y el Client secret.

El Client secret se muestra una sola vez. Si lo perdés hay que regenerarlo, y al regenerarlo se invalida el que estaba en uso — incluida la conexión con Tours Tico, que habría que rehacer.

2. Conectar en Tours Tico

Ruta: Ajustes → Cobros → Pasarela de pago → Conectar una pasarela

1. En Proveedor, elegí CoinPayments.
2. En Modo, elegí Prueba o Producción (mirá abajo qué significa acá).
3. Pegá el Client ID y el Client secret.
4. Presioná Conectar.

Tours Tico prueba las credenciales contra CoinPayments antes de guardarlas, así que si algo está mal te enterás en el momento.

El aviso automático (webhook) lo configuramos nosotros. No tenés que crear nada en CoinPayments ni copiar ningún secreto: al conectar, Tours Tico registra el aviso en tu integración, y al desconectar lo borra. Sirve para que una reserva se confirme sola aunque el turista cierre el navegador después de pagar.

3. El modo Prueba acá es distinto

CoinPayments no tiene una cuenta de prueba aparte. Se prueba con una moneda de prueba, LTCT (Litecoin testnet), en la misma cuenta:

1. En CoinPayments, andá a Balances y buscá la fila LTCT → Get Free LTCT. Te dan 10 al instante y no hace falta tener la verificación aprobada.
2. Armá una reserva de prueba en Tours Tico y pagala desde el enlace, eligiendo Litecoin Test.
3. Cuando termines, apagá LTCT: Payment Settings → Litecoin Testnet (LTCT) → Settlement mode → Disabled.

Apagarla no es opcional: si queda encendida, un cliente real podría pagarte con una moneda de prueba que no vale nada. El modo de Tours Tico no la apaga — solo cambia lo que la pantalla te dice.

4. Qué ve el turista

Cuando abre su enlace de pago ve Pagar con cripto. Al tocarlo se abre la página segura de CoinPayments, donde:

• Elige con qué criptomoneda pagar, y ve el monto convertido al momento.
• Recibe una dirección para transferir, con un reloj: tiene 60 minutos para que el pago salga.
• Puede dejar su correo para que CoinPayments le escriba si hay un problema con el pago (sobrepagos, pagos tardíos).

Cuando vuelve a tu enlace, la reserva ya está confirmada, o queda esperando las confirmaciones de la red.

Una reserva pagada en cripto se confirma cuando el dinero está ACREDITADO en tu cuenta, no cuando la transacción aparece en la red. Es una diferencia de minutos y es a propósito: hasta que CoinPayments no acredita, ese pago todavía puede caerse.

5. Devolver un pago

Ruta: el detalle de la reserva → sección Pago → Devolver.

El recuadro te lo dice: en cripto la devolución no se pide desde acá. El orden es:

1. Pedile al cliente la wallet a la que quiere recibir el dinero, y en qué moneda.
2. Transferí desde tu cuenta de CoinPayments (Balances → la moneda → Send, con tu 2FA).
3. Volvé a la reserva, tocá Devolver y anotá: el monto, el hash de la transacción (obligatorio), la wallet del cliente y una nota si hace falta.

Con eso la reserva queda como devuelta y el movimiento queda registrado con su comprobante. El hash es obligatorio a propósito: sin él, el sistema estaría afirmando que devolviste algo que nadie puede verificar — ni vos, ni el cliente, ni una auditoría más adelante.

6. Conciliar

Cada cobro aparece en tu Dashboard de CoinPayments. En Tours Tico, el detalle del pago guarda la moneda con la que pagó el turista, el monto recibido y el hash de la transacción en la cadena, que es lo que te permite reconocer el movimiento.

7. CoinPayments te va a escribir

Aparte de Tours Tico, CoinPayments le manda correos a la cuenta del negocio: uno por cada pago que un turista inicia («new payment initiated», apenas elige la moneda en el checkout, mucho antes de pagar) y avisos si algo falla de su lado. No son errores del panel ni cosas que tengas que resolver: son de CoinPayments hacia vos. Si te llega uno hablando de un problema con la «webhook URL», avisale al equipo de Tours Tico con el texto tal cual.

Problemas frecuentes

• Conecté y no me pidió ningún secreto de webhook. Es lo esperado: acá lo registramos nosotros. (Si venís de conectar ONVO Pay, ahí sí hay un paso extra; en CoinPayments no.)
• El turista pagó y la reserva sigue pendiente. Lo más probable es que la red todavía esté confirmando, o que CoinPayments aún no haya acreditado el pago a tu balance. Pedile que vuelva a abrir su enlace en un rato: al abrirlo, Tours Tico vuelve a consultar y confirma si ya entró.
• El turista pagó de menos. CoinPayments tiene un límite de tolerancia que se configura en Payment Settings (un monto fijo, un porcentaje, o ambos). Un pago por debajo del límite no completa el invoice y el turista recibe instrucciones de reembolso de parte de CoinPayments.
• El turista pagó de más. CoinPayments completa el cobro y le devuelve el excedente solo.
• Pasó una hora y no pagó. El invoice vence y la reserva sigue esperando su plazo normal. Puede volver al enlace y empezar de nuevo: se abre un cobro nuevo.
• No aparece la moneda que quiere el cliente. Las monedas que aceptás se configuran en CoinPayments, no en Tours Tico.