
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.
Códigos na API v2. Além das moedas, a API v2 também cobre códigos. Ela tem token próprio e lista chaves de jogos, assinaturas, gift cards e recargas, e moeda dentro do jogo: leia o catálogo com GET /api/reseller/v2/codes (um item: GET /codes/{sku}) e compre com POST /orders e items[].sku. O código é devolvido em GET /orders/{id}. A referência completa está na página de API do painel de revendedores.
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
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?+
Sim, na API v2. No painel de revenda (API & webhooks) ou com PUT /webhooks, informe um endereço https e escolha os eventos, por exemplo order.status_changed e order.delivered. Assinamos cada envio com X-SC-Signature e tentamos de novo os que falham após 1, 5, 15, 60 e 240 minutos. A API v1 não tem webhooks: nela, consulte a lista de pedidos em um intervalo razoável. A API v2 usa um token próprio.
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.
Também posso comprar chaves de jogos e assinaturas?+
Sim. O painel tem centenas de códigos: chaves de jogos para Steam, PlayStation, Xbox, Nintendo Switch, GOG, PC e outras plataformas, assinaturas como Xbox Game Pass e PlayStation Plus, gift cards e recargas, e moeda dentro do jogo. Você paga com o saldo do painel ou pede pela API v2. O código aparece no seu painel assim que o pedido é concluído, e cada item mostra a região.
Quer automatizar sua loja de moedas?Cadastre-se como revendedor e, assim que sua conta for aprovada, liberamos a API para você.Quero ser revendedor