Preguntas y respuestas
Lo que preguntan los integradores antes del primer pedido, agrupado y respondido corto. Donde la respuesta pertenece al contrato y no a una costumbre nuestra, la documentación de la API dice lo mismo con detalle.
Energía y precio
¿Qué es la energía de TRON?
Un recurso de la red que paga la ejecución de contratos inteligentes. Con suficiente energía en la cartera de origen, una transferencia USDT casi no quema TRX.
¿Por qué es más barata que quemar?
Quemar valora la energía a la tarifa del protocolo, ~210 sun por unidad, un número que no se mueve nunca. Nosotros conseguimos energía delegada al por mayor y la vendemos a una fracción de esa tarifa; el precio vigente ahora mismo está en la página de precios.
Ver todos los precios →
¿Y si se me pasa la ventana de 4 minutos?
En el mode A el cobro se mantiene: la energía se entregó, y lo que usted paga es la entrega. En el mode B no emitimos nada una vez cerrada la ventana, así que la posición falla y la reserva vuelve entera. La ventana viene con cada pedido; construya su flujo alrededor de ella.
¿Perder la ventana de envío cuesta lo mismo en los dos modos?
No. En el mode A la energía se entregó, así que el cobro se mantiene — y en el mode C también, donde no hay transferencia que esperar y la posición simplemente vence al cerrarse la ventana. En el mode B no emitimos nada una vez cerrada la ventana: una transferencia enviada tarde encontraría una cartera de la que la energía delegada ya se retiró, y quemaría su TRX. La posición se cierra como failed con broadcast_window_missed, la reserva vuelve entera y la energía que compramos para ella es pérdida nuestra.
Dinero y devoluciones
¿Cómo se paga?
Saldo de servicio prepagado, denominado en TRX: envíe TRX a su dirección personal y gástelo en servicios. Los precios se fijan al crear el pedido.
¿Qué token puedo enviar a mi dirección de depósito?
TRX, y solo TRX. El USDT enviado a una dirección de depósito no se acredita automáticamente: no asumimos riesgo de tipo de cambio ni operamos un servicio de conversión, así que queda apartado para que lo mire una persona y acreditarlo es decisión nuestra caso por caso. ¿Envió el token equivocado? Escríbanos y no envíe más.
¿Cuándo puedo gastar un depósito?
Tras 3 confirmaciones, unos diez segundos. El saldo se informa entonces en tres partes: el total, lo reservado para pedidos en curso y lo disponible. El pedido se crea desde la parte disponible, nunca desde el total.
¿Puedo cancelar un pedido?
Solo antes de que empiece la compra; después la respuesta es order_not_cancelable, porque la energía ya está comprada. Un pedido cancelado libera su reserva íntegra y no cobra nada.
¿Y las devoluciones?
Las liberaciones son automáticas y nunca hacen falta tickets. La regla es una: la energía que no entregamos no se cobra, y la reserva vuelve a su saldo en crédito de servicio — una entrega fallida, un pedido cancelado antes de que empezara la compra, la parte no gastada de un día de Auto-refill. La energía entregada se cobra, la haya usado o no.
Seguridad y claves
¿Qué claves necesitan?
Ninguna. El mode A nunca ve su transacción. El mode B recibe una que usted ya firmó, y no podemos alterar ni un byte de ella.
¿Aceptan un remitente con multifirma?
En el mode B, no: la transacción debe llevar exactamente una firma del propietario, con Permission_id 0. El conjunto de claves de una cuenta multifirma vive en la red y cambia sin que lo sepamos, así que no podemos prometer que la emisión sea aceptada. En el mode A nada de cómo firma usted llega hasta nosotros: la transferencia la emite usted mismo.
¿Qué guardan y durante cuánto tiempo?
En el mode B su transacción firmada se guarda cifrada y se borra 7 días después de que el pedido alcance un estado final. Los pedidos, los asientos del libro y los depósitos se quedan: eso es contabilidad, y es lo que estamos obligados a conservar. De usted no hay nada más aquí: ni claves privadas, ni frases semilla, ni custodia de sus fondos.
Integración
¿Hay límites?
120 pedidos por minuto y clave, hasta 500 transferencias por pedido en lote. Al pasarse del límite recibe Retry-After, no un descarte en silencio.
¿Qué significa completed en realidad?
Que la energía se entregó, no que su transferencia se envió. El compromiso es la entrega, y el pedido se cierra con ella: en el mode A completed puede llegar antes de que usted haya enviado nada. Vigile la aparición de send_before en el pedido y no la palabra ready: consultando cada dos segundos puede no ver ready ni una sola vez.
¿Cómo funciona la idempotencia?
Una Idempotency-Key queda ligada a los bytes crudos del cuerpo con el que llegó. La misma clave con un cuerpo idéntico byte a byte devuelve el mismo pedido; la misma clave con otro cuerpo es un conflicto; una petición rechazada por la validación no gasta la clave, así que puede repetirla con la misma clave una vez corregido el cuerpo. Serialice el cuerpo una vez y reenvíe esos mismos bytes: otro orden de claves o un espacio de más ya es otro cuerpo.
¿Puedo comprobar una dirección sin pagar nada?
Sí, y es gratis. GET /v1/address-check cuenta lo que sabemos de una cartera, y POST /v1/estimate calcula hasta 500 destinatarios con las mismas reglas que usaría un pedido, incluido cuáles de ellos están en la lista negra del contrato del token. Ninguno de los dos reserva nada ni cobra nada.
Su cuenta
¿Puede una cartera mantenerse recargada sola?
Sí: una regla de Auto-refill, una dirección más un presupuesto diario. La energía se rellena después de cada transferencia; el presupuesto es un techo diario infranqueable.
¿En cuánto conviene poner balance.low?
El número lo pone usted — balance_low_threshold_trx en PATCH /v1/settings; balance.low es el evento que salta con él. La medida útil es aproximadamente su movimiento de un día: así el aviso llega un día antes de que los pedidos empiecen a recibir insufficient_balance, en vez de llegar en lugar del primer rechazo. Bastante más bajo y el evento es un aviso a posteriori; bastante más alto y es ruido. Cero lo apaga.
¿Hay un entorno de pruebas o un volumen mínimo?
Ni volumen mínimo, ni suscripción, ni pago por estar parado. Tampoco hay entorno de pruebas: la URL base es la de producción y no existe otra. Los endpoints de consulta, una estimación y una prueba de webhook no cuestan nada, así que casi toda la integración puede construirse antes de que exista un solo pedido.