API de moedas FC para revendedores: automatize os pedidos da sua loja
Resposta rápida
A API de revenda da SuperCoinsy permite que seu site ou bot consulte estoque e preços, crie e pague pedidos com o seu saldo em EUR, acompanhe o status e envie mensagens à nossa equipe. Ela usa autorização por token e cada usuário da API fica vinculado a um endereço IP. O acesso é liberado para contas de revenda aprovadas.
O que dá para automatizar
- Estoque - veja o que podemos entregar agora, por plataforma, antes de mostrar um botão de compra.
- Preços - puxe seu preço de revenda atual por plataforma, para manter suas margens onde você quer.
- Pedidos - crie e pague um pedido em uma única chamada. Se o saldo for insuficiente, o pedido não é criado.
- Status - liste seus pedidos ou veja os detalhes de um pedido, incluindo o prazo máximo de entrega.
- Mensagens - adicione uma mensagem a um pedido, por exemplo para enviar novos códigos de backup.
- Cancelamentos - envie um pedido de cancelamento.
Como um pedido flui pela API
1Confira estoque e preçoChame available-stock e prices antes de receber o pagamento do seu cliente.
2Crie o pedidoEnvie a quantidade em K, a plataforma e os dados de acesso EA do seu cliente com códigos de backup novos. Se quiser, adicione sua própria referência do pedido.
3Guarde o número do pedidoA resposta traz um número de pedido como R_QWERTY. Todas as chamadas seguintes usam esse número.
4Acompanhe o statusConsulte a lista ou os detalhes do pedido em um intervalo razoável e mostre o status ao seu cliente.
5Reaja quando necessárioSe nossa equipe pedir novos códigos de backup, envie-os como mensagem no pedido.
Exemplo de requisição (valores de teste)
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"
}Como conseguir acesso
1Tenha sua conta de revenda aprovadaCadastre-se na página de revenda.
2Peça para liberarmos a APIFale com nosso gerente no Discord (supercoinsy) ou escreva para [email protected].
3Crie um usuário da APINo painel de revenda, informe o endereço IP do seu servidor. Você recebe um token e um identificador curto.
4Guarde o token com segurança e ative o usuárioO token aparece só uma vez. Você pode desativar ou excluir um usuário da API a qualquer momento.
Boas práticas
- A quantidade é sempre em K. Envie 150 para 150.000 moedas. Enviar o número completo criaria um pedido mil vezes maior.
- "ps" significa todos os consoles. Há dois valores de plataforma: pc e ps. Pedidos de Xbox entram como ps.
- Códigos de backup são de uso único. Envie sempre códigos novos. Códigos usados não permitem o login, e o pedido fica aguardando.
- Consulte com moderação. Verifique o status a cada poucos minutos, não em um loop contínuo.
- Atualize os preços com frequência. Não deixe os preços fixos no código da sua loja.
- Trate o token como uma senha. Use um usuário da API por servidor e, se um token vazar, desative esse usuário e crie um novo.
- Proteja os dados dos seus clientes. Envie dados de login só por HTTPS e não os guarde nos seus logs.
Referência completa dos endpoints, com exemplos de requisição e resposta: documentação da API de revenda.
Perguntas frequentes
Preciso da API para trabalhar com vocês?+
Não. Tudo o que a API faz também pode ser feito manualmente no painel de revenda. A API é para lojas que querem automatizar os pedidos.
Existe webhook para mudanças de status?+
Ainda não. Consulte a lista ou os detalhes do pedido em um intervalo razoável para ver as mudanças de status.
Como consigo acesso à API?+
Depois que sua conta de revenda for aprovada, peça ao nosso gerente no Discord ou por e-mail para liberar o acesso à API. Depois crie um usuário da API com o endereço IP do seu servidor no painel de revenda.
