API de monedas FC para revendedores: automatiza los pedidos de tu tienda
Respuesta corta
La API para revendedores de SuperCoinsy permite que tu sitio web o bot consulte stock y precios, cree y pague pedidos con tu saldo en EUR, siga su estado y envíe mensajes a nuestro equipo. Usa autorización con token y cada usuario de la API está vinculado a una dirección IP. El acceso se activa para cuentas de revendedor aprobadas.
Qué puedes automatizar
- Stock - consulta lo que podemos entregar ahora mismo, por plataforma, antes de mostrar un botón de compra.
- Precios - trae tu precio de revendedor actual por plataforma, para mantener tus márgenes donde quieres.
- Pedidos - crea y paga un pedido en una sola llamada. Si tu saldo no alcanza, el pedido no se crea.
- Estado - lista tus pedidos o consulta el detalle de uno, incluido el tiempo máximo de entrega.
- Mensajes - agrega un mensaje a un pedido, por ejemplo para enviar códigos de respaldo nuevos.
- Cancelaciones - envía una solicitud de cancelación de un pedido.
Cómo fluye un pedido por la API
1Consulta stock y precioLlama a available-stock y prices antes de cobrarle a tu cliente.
2Crea el pedidoEnvía la cantidad en K, la plataforma y los datos de acceso EA de tu cliente con códigos de respaldo nuevos. Si quieres, agrega tu propia referencia de pedido.
3Guarda el número de pedidoLa respuesta devuelve un número de pedido como R_QWERTY. Todas las llamadas posteriores lo usan.
4Sigue el estadoConsulta la lista o el detalle del pedido cada cierto tiempo razonable y muestra el estado a tu cliente.
5Reacciona cuando haga faltaSi nuestro equipo pide códigos de respaldo nuevos, envíalos como mensaje en el pedido.
Ejemplo de solicitud (valores de prueba)
POST https://supercoinsy.com/api/reseller/new-transaction
X-Authorization: <your 60-character token>
X-UserID: <your 6-character identifier>
Content-Type: application/json
{
"quantity": 150,
"platform": "pc",
"emailapp": "[email protected]",
"passapp": "customer-password",
"codesapp": "code1, code2, code3",
"userorderid": "SHOP-1042"
}Cómo obtener acceso
1Consigue la aprobación de tu cuenta de revendedorPostúlate en la página de revendedores.
2Pídenos que activemos la APIEscribe a nuestro manager en Discord (supercoinsy) o a [email protected].
3Crea un usuario de la APIEn el panel de revendedor, ingresa la dirección IP de tu servidor. Recibes un token y un identificador corto.
4Guarda el token en un lugar seguro y activa el usuarioEl token se muestra una sola vez. Puedes desactivar o eliminar un usuario de la API en cualquier momento.
Buenas prácticas
- La cantidad siempre va en K. Envía 150 para 150.000 monedas. Enviar el número completo crearía un pedido mil veces más grande.
- "ps" significa todas las consolas. Hay dos valores de plataforma: pc y ps. Los pedidos de Xbox van como ps.
- Los códigos de respaldo son de un solo uso. Envía siempre códigos nuevos. Con códigos usados no podemos entrar y el pedido queda en espera.
- Consulta con moderación. Revisa el estado cada pocos minutos, no en un bucle continuo.
- Actualiza los precios seguido. No los dejes fijos en el código de tu tienda.
- Trata el token como una contraseña. Usa un usuario de la API por servidor y, si se filtra un token, desactiva ese usuario y crea uno nuevo.
- Protege los datos de tus clientes. Envía los datos de acceso solo por HTTPS y no los guardes en tus logs.
Referencia completa de endpoints con ejemplos de solicitud y respuesta: documentación de la API para revendedores (en inglés).
Preguntas frecuentes
¿Necesito la API para trabajar con ustedes?+
No. Todo lo que hace la API también se puede hacer a mano en el panel de revendedor. La API es para tiendas que quieren automatizar sus pedidos.
¿Hay webhook para los cambios de estado?+
Todavía no. Consulta la lista o el detalle del pedido cada cierto tiempo razonable para ver los cambios de estado.
¿Cómo obtengo acceso a la API?+
Cuando tu cuenta de revendedor esté aprobada, pide a nuestro manager en Discord o por correo que active el acceso a la API. Luego crea un usuario de la API con la dirección IP de tu servidor en el panel de revendedor.
