API para panel SMM en México

La página de revendedores explica cómo comprar un servicio para un cliente y fijar el precio de cara al público. Esta no. Aquí el tema es automatizar: tu panel, tu tienda o tu script habla con FalconGrow y el pedido sale sin que alguien lo arme a mano.

El panel general de México sirve para elegir un servicio en la web. Si el pedido lo arma una persona, esa es la ficha. Si lo arma un programa, es esta. No hace falta repetir aquí cómo se cobra a un cliente ni qué margen te queda: eso no lo decide esta conexión.

La URL que se pega como proveedor es https://www.falcongrow.com/api/v2. La llamada es POST. La clave va en el parámetro key y la acción en action. La respuesta es JSON. Si algo falla, el HTTP sigue en 200 y el cuerpo trae un campo error.

La clave se genera en el perfil, en la sección de API, y no es la contraseña de la web ni la sesión. La sesión se cierra al salir. La clave sigue hasta que la regeneras en ese mismo perfil: la anterior deja de servir en cuanto guardas la nueva.

Un panel hijo del formato habitual, el tipo Perfect Panel y otros scripts del rubro, agrega FalconGrow como proveedor con esa URL y esa clave. No hace falta un adaptador ni una dirección distinta por acción: todas usan la misma URL.

Las acciones soportadas son services, balance, add, status, refill y cancel. Con ellas se consulta el catálogo y el importe disponible, se crea una orden, se mira cómo va —hasta 100 pedidos en una sola llamada— y se detiene un pedido que todavía no empezó, cuando el servicio lo permite. También se puede volver a pedir la entrega cuando el servicio sí incluye reposición.

refill_status es distinto: se acepta por compatibilidad con esos scripts, pero responde error. No está soportada y no consulta el estado de una entrega ya repetida.

Conviene guardar la respuesta del catálogo. No cambia en cada minuto, y repetirla en cada pedido gasta el ritmo de la clave sin aportar un dato nuevo.

La llamada que crea la orden no lleva un medio de pago. Descuenta el saldo en dólares que ya está en la cuenta. Si ese saldo no alcanza, la orden no se crea: primero hay que cargarlo.

La API descuenta el saldo en dólares de la cuenta. Para cargar ese saldo se usan PayPal o cripto (desde US$ 10). Si cargas saldo con PayPal, el tipo de cambio lo aplica PayPal o tu banco. FalconGrow no publica esa cotización. Con cripto cargas el equivalente en la criptomoneda que elijas.

Esta página no publica un margen, una rentabilidad ni una cotización en otra moneda. Lo que le cobras a tu cliente, si además revendes, se decide en la ficha de revendedores, no aquí.

Cada clave puede hacer 120 solicitudes por minuto. Pasado ese ritmo, la llamada no se procesa y hay que esperar el minuto siguiente. No publicamos otro tope ni un plan de volumen aparte.

El mismo ritmo vale para consultar el catálogo, el importe, el estado o para crear la orden. Por eso el catálogo se guarda del lado de tu sistema y el estado de varios pedidos se pide junto, hasta el máximo de esa acción.

Si estás en otro país, la página general de la API describe la misma conexión, con la misma URL y las mismas acciones. Esta ficha solo añade cómo se carga el saldo desde aquí, con los medios que el sitio puede anunciar.

Quien solo quiere un pedido para su propia cuenta, o armar a mano el pedido de un cliente, usa el panel o la ficha de revendedores. La documentación larga de cada parámetro sigue en su página, al lado de esta conexión.