API de moedas FC para revendedores: automatize os pedidos da sua loja

Última atualização:

API de moedas FC para revendedores

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

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?+
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
deliver
Verificar

Estado do pedido ou da ordem de venda