# Rivoo

- [Documentação da Rivoo](/): Monte a loja do seu servidor, receba no Pix e entregue no jogo. Para lojistas, devs e IA.
- Começar
  - [Criar a loja](/comecar/criar-loja): Da conta nova à loja no ar, em uns 10 minutos.
  - [Primeira venda](/comecar/primeira-venda): Compre na sua própria loja com um Pix de R$ 1 e veja o pedido, a entrega no jogo e o saldo.
  - [Taxas e saque](/comecar/taxas-e-saque): Quanto custa cada venda, quando o dinheiro entra e como sacar.
- Guias do lojista
  - [Produtos e categorias](/guias/produtos-e-categorias): Cadastre VIPs, ranks, kits e moedas, com preço, validade, regras de compra e entrega.
  - [Ranks e upgrade](/guias/ranks-e-upgrade): Escada de ranks em que o jogador sobe pagando só a diferença.
  - [Assinatura e Pix Automático](/guias/assinatura-e-pix-automatico): VIP mensal que renova sozinho, no Pix Automático ou no cartão.
  - [Cupons e promoções](/guias/cupons-e-promocoes): Descontos com código, promoções automáticas com prazo e regras por comprador.
  - [Presentes e gift cards](/guias/presentes-e-gift-cards): Comprar para outro jogador e vender saldo de presente.
  - [Códigos de criador](/guias/codigos-de-criador): Parceria com streamers e criadores, com desconto para o comprador e comissão para eles.
  - [Meta da comunidade](/guias/meta-da-comunidade): Uma barra de progresso na vitrine e uma recompensa para todo o servidor quando a meta é batida.
  - [Recuperação de carrinho](/guias/recuperacao-de-carrinho): Lembrete por e-mail para quem não pagou e agradecimento para quem pagou.
  - [Discord](/guias/discord): Cargo automático para quem compra e avisos de venda no seu servidor do Discord.
  - [Domínio próprio](/guias/dominio-proprio): A loja no seu domínio, como loja.seuservidor.com, com HTTPS.
  - [Editor da vitrine](/guias/editor-da-vitrine): Template, blocos, cores e conteúdo da loja, com prévia antes de publicar.
- Entrega no jogo
  - [Plugin Minecraft](/entrega/plugin-minecraft): Instale o plugin no servidor Paper e entregue VIP, ranks e kits na hora do pagamento.
  - [Jogador offline](/entrega/jogador-offline): O que acontece quando o comprador não está no servidor na hora do pagamento.
  - [Agente RCON (beta)](/entrega/agente-rcon): Entrega em Rust, ARK, Palworld, 7 Days to Die e outros jogos com RCON, sem plugin.
  - [Entrega manual](/entrega/entrega-manual): Para o que a equipe entrega à mão, com contador de pendentes no painel.
- API
  - [API](/api): Integre seu site, bot ou sistema com a loja. REST, JSON, autenticação por chave.
  - [Autenticação](/api/autenticacao): Chaves de API por loja, com permissão por recurso.
  - [Erros](/api/erros): Formato dos erros (problem+json) e os códigos mais comuns.
  - [Paginação](/api/paginacao): Listas por cursor, do mais novo ao mais antigo.
  - [Idempotência](/api/idempotencia): Repita uma chamada sem criar nada em dobro.
  - [Limites](/api/limites): Quantas chamadas por minuto cada chave pode fazer.
  - Referência
    - Ações de entrega
      - [Alterar ação da loja](/api/referencia/acoes-de-entrega/alterar-acao-da-loja): Altera só os campos enviados da ação.
      - [Alterar ação do produto](/api/referencia/acoes-de-entrega/alterar-acao-do-produto): Altera só os campos enviados da ação.
      - [Criar ação da loja](/api/referencia/acoes-de-entrega/criar-acao-da-loja): Adiciona um comando ou cargo que roda em toda compra.
      - [Criar ação do produto](/api/referencia/acoes-de-entrega/criar-acao-do-produto): Adiciona um comando no servidor ou cargo no Discord ao produto, com o momento em que roda.
      - [Listar ações da loja](/api/referencia/acoes-de-entrega/listar-acoes-da-loja): Ações que rodam em toda compra, de qualquer produto.
      - [Listar ações do produto](/api/referencia/acoes-de-entrega/listar-acoes-do-produto): Comandos e cargos que o produto entrega quando o pedido é pago, expira ou é reembolsado.
      - [Remover ação da loja](/api/referencia/acoes-de-entrega/remover-acao-da-loja): Remove a ação da loja.
      - [Remover ação do produto](/api/referencia/acoes-de-entrega/remover-acao-do-produto): Remove a ação. Entregas já feitas não são desfeitas.
    - Arquivos
      - [Adicionar arquivo](/api/referencia/arquivos/adicionar-arquivo): Anexa um arquivo ao produto para download após a compra.
      - [Listar arquivos](/api/referencia/arquivos/listar-arquivos): Arquivos que o comprador baixa pelo recibo depois do pagamento.
      - [Remover arquivo](/api/referencia/arquivos/remover-arquivo): Remove o arquivo do produto. Links já enviados deixam de funcionar.
    - Assinaturas
      - [Cancelar assinatura](/api/referencia/assinaturas/cancelar-assinatura): Cancela a renovação. O benefício vale até o fim do período pago.
      - [Criar assinatura](/api/referencia/assinaturas/criar-assinatura): Cria uma assinatura e devolve o link para o comprador autorizar o Pix Automático ou o cartão.
      - [Listar assinaturas](/api/referencia/assinaturas/listar-assinaturas): Assinaturas da loja, com status e próxima cobrança.
      - [Resumo das assinaturas](/api/referencia/assinaturas/resumo-das-assinaturas): Ativas, receita recorrente do mês e cancelamentos.
      - [Retomar assinatura](/api/referencia/assinaturas/retomar-assinatura): Desfaz o cancelamento antes do fim do período.
      - [Ver assinatura](/api/referencia/assinaturas/ver-assinatura): Devolve a assinatura com as cobranças.
    - Benefícios
      - [Listar benefícios](/api/referencia/beneficios/listar-beneficios): Benefícios entregues (ranks, assinaturas, itens), com início e fim.
      - [Revogar benefício](/api/referencia/beneficios/revogar-beneficio): Encerra o benefício agora e roda as ações de fim do produto.
    - Bloqueios
      - [Bloquear comprador](/api/referencia/bloqueios/bloquear-comprador): Impede um jogador, e-mail, conta do Discord ou IP de comprar na loja.
      - [Desbloquear comprador](/api/referencia/bloqueios/desbloquear-comprador): Remove o bloqueio.
      - [Listar bloqueios](/api/referencia/bloqueios/listar-bloqueios): Jogadores, e-mails, contas do Discord e IPs impedidos de comprar na loja.
    - Categorias
      - [Alterar categoria](/api/referencia/categorias/alterar-categoria): Altera só os campos enviados da categoria.
      - [Arquivar categoria](/api/referencia/categorias/arquivar-categoria): Tira a categoria da vitrine. Pedidos antigos continuam apontando para ela.
      - [Criar categoria](/api/referencia/categorias/criar-categoria): Cria uma categoria. Categorias escalonadas viram uma escada de ranks com upgrade pagando a diferença.
      - [Listar categorias](/api/referencia/categorias/listar-categorias): Lista as categorias da loja na ordem da vitrine.
      - [Ordenar categorias](/api/referencia/categorias/ordenar-categorias): Define a ordem das categorias na vitrine pela lista de ids enviada.
      - [Ver categoria](/api/referencia/categorias/ver-categoria): Devolve uma categoria.
    - Chaves de API
      - [Listar chaves de API](/api/referencia/chaves-de-api/listar-chaves-de-api): Lista as chaves da loja com prefixo, permissões e último uso. O segredo nunca volta.
    - Chaves de licença
      - [Importar chaves de licença](/api/referencia/chaves-de-licenca/importar-chaves-de-licenca): Adiciona chaves ao estoque. Cada compra paga recebe uma chave por e-mail.
      - [Listar chaves de licença](/api/referencia/chaves-de-licenca/listar-chaves-de-licenca): Estoque de chaves do produto: livres, entregues e revogadas.
      - [Revogar chave de licença](/api/referencia/chaves-de-licenca/revogar-chave-de-licenca): Marca a chave como revogada; ela não é entregue de novo.
    - Clientes
      - [Adicionar identidade](/api/referencia/clientes/adicionar-identidade): Liga uma conta de jogo ao cliente.
      - [Alterar cliente](/api/referencia/clientes/alterar-cliente): Altera só os campos enviados do cliente.
      - [Arquivar cliente](/api/referencia/clientes/arquivar-cliente): Arquiva o cliente. Pedidos e benefícios ficam no histórico.
      - [Benefícios do cliente](/api/referencia/clientes/beneficios-do-cliente): Benefícios ativos e encerrados do cliente (ranks, assinaturas, itens).
      - [Criar cliente](/api/referencia/clientes/criar-cliente): Cadastra um cliente com e-mail e, se quiser, identidades de jogo.
      - [Listar clientes](/api/referencia/clientes/listar-clientes): Lista os clientes da loja, com busca por e-mail ou nick.
      - [Listar identidades](/api/referencia/clientes/listar-identidades): Contas de jogo do cliente (nick do Minecraft, Steam, Discord…).
      - [Remover identidade](/api/referencia/clientes/remover-identidade): Desliga a conta de jogo do cliente.
      - [Ver cliente](/api/referencia/clientes/ver-cliente): Devolve um cliente com total gasto e número de pedidos.
    - Comandos
      - [Cancelar comando](/api/referencia/comandos/cancelar-comando): Cancela um comando que ainda está na fila.
      - [Enviar comando de teste](/api/referencia/comandos/enviar-comando-de-teste): Envia um comando a um servidor, sem pedido, para testar a entrega.
      - [Listar comandos](/api/referencia/comandos/listar-comandos): Comandos enviados aos servidores, com status (na fila, entregue, falhou).
      - [Reenviar comandos](/api/referencia/comandos/reenviar-comandos): Reenvia ao servidor os comandos de um pedido.
      - [Ver comando](/api/referencia/comandos/ver-comando): Devolve o comando com as tentativas e a resposta do servidor.
    - Configurações
      - [Alterar configurações](/api/referencia/configuracoes/alterar-configuracoes): Altera só os campos enviados das configurações da loja.
      - [Ver configurações](/api/referencia/configuracoes/ver-configuracoes): Devolve as configurações da loja: nome, moeda, e-mails e regras de checkout.
    - Criadores
      - [Alterar criador](/api/referencia/criadores/alterar-criador): Altera só os campos enviados do criador.
      - [Apagar pagamento ao criador](/api/referencia/criadores/apagar-pagamento-ao-criador): Remove um registro de pagamento de comissão.
      - [Arquivar criador](/api/referencia/criadores/arquivar-criador): Desativa o código do criador.
      - [Criar criador](/api/referencia/criadores/criar-criador): Cadastra um criador com código, desconto para o comprador e comissão.
      - [Listar criadores](/api/referencia/criadores/listar-criadores): Criadores de conteúdo com código de desconto e comissão.
      - [Pagamentos ao criador](/api/referencia/criadores/pagamentos-ao-criador): Pagamentos de comissão registrados pela loja.
      - [Registrar pagamento ao criador](/api/referencia/criadores/registrar-pagamento-ao-criador): Registra que a loja pagou a comissão do criador.
      - [Relatório do criador](/api/referencia/criadores/relatorio-do-criador): Vendas e comissão do criador por mês, descontados reembolsos e disputas perdidas.
      - [Ver criador](/api/referencia/criadores/ver-criador): Devolve o criador.
    - Cupons e promoções
      - [Alterar cupom ou promoção](/api/referencia/cupons-e-promocoes/alterar-cupom-ou-promocao): Altera só os campos enviados do desconto.
      - [Arquivar cupom ou promoção](/api/referencia/cupons-e-promocoes/arquivar-cupom-ou-promocao): Encerra o desconto. Pedidos que já usaram continuam com ele.
      - [Criar cupom ou promoção](/api/referencia/cupons-e-promocoes/criar-cupom-ou-promocao): Cria um desconto em porcentagem ou valor, com prazo, limite de usos, gasto mínimo e produtos.
      - [Listar cupons e promoções](/api/referencia/cupons-e-promocoes/listar-cupons-e-promocoes): Lista cupons (com código) e promoções automáticas da loja.
      - [Usos do cupom](/api/referencia/cupons-e-promocoes/usos-do-cupom): Pedidos que usaram o desconto, com o valor descontado em cada um.
      - [Ver cupom ou promoção](/api/referencia/cupons-e-promocoes/ver-cupom-ou-promocao): Devolve um desconto com as regras e o número de usos.
    - Discord
      - [Canais do Discord](/api/referencia/discord/canais-do-discord): Canais de texto do servidor do Discord, para os avisos de venda.
      - [Cargos do Discord](/api/referencia/discord/cargos-do-discord): Cargos do servidor do Discord, para usar nas ações de entrega.
      - [Configurar avisos do Discord](/api/referencia/discord/configurar-avisos-do-discord): Define os canais e o modelo da mensagem de venda.
      - [Testar avisos do Discord](/api/referencia/discord/testar-avisos-do-discord): Manda uma mensagem de teste nos canais configurados.
      - [Ver avisos do Discord](/api/referencia/discord/ver-avisos-do-discord): Canal e modelo do anúncio público de venda e do canal da equipe.
    - Disputas
      - [Aceitar disputa](/api/referencia/disputas/aceitar-disputa): Aceita a contestação sem defesa; o valor volta ao comprador.
      - [Enviar defesa](/api/referencia/disputas/enviar-defesa): Envia as provas para análise. Depois disso não dá para anexar mais.
      - [Enviar prova](/api/referencia/disputas/enviar-prova): Anexa uma prova à disputa (comprovante de entrega, conversa, log do servidor).
      - [Listar disputas](/api/referencia/disputas/listar-disputas): Contestações abertas pelos compradores (chargeback e MED do Pix).
      - [Ver disputa](/api/referencia/disputas/ver-disputa): Devolve a disputa com prazo e provas enviadas.
    - Domínio próprio
      - [Desligar domínio próprio](/api/referencia/dominio-proprio/desligar-dominio-proprio): Desliga o domínio; a loja volta a responder só no endereço da Rivoo.
      - [Ligar domínio próprio](/api/referencia/dominio-proprio/ligar-dominio-proprio): Liga um domínio seu à loja. Devolve o registro DNS que você precisa criar.
      - [Ver domínio próprio](/api/referencia/dominio-proprio/ver-dominio-proprio): Domínio ligado à loja e o estado da verificação e do certificado.
      - [Verificar domínio](/api/referencia/dominio-proprio/verificar-dominio): Confere o DNS agora e, se estiver certo, emite o certificado.
    - Entregas
      - [Contar entregas manuais](/api/referencia/entregas/contar-entregas-manuais): Quantas entregas manuais estão pendentes.
      - [Entregas manuais pendentes](/api/referencia/entregas/entregas-manuais-pendentes): Itens que a equipe entrega à mão.
      - [Listar entregas](/api/referencia/entregas/listar-entregas): Entregas dos pedidos (comandos, cargos, chaves, arquivos) e o status de cada uma.
      - [Marcar como entregue](/api/referencia/entregas/marcar-como-entregue): Marca a entrega manual como feita.
      - [Tentar entrega de novo](/api/referencia/entregas/tentar-entrega-de-novo): Roda de novo uma entrega que falhou.
    - Eventos
      - [Listar eventos](/api/referencia/eventos/listar-eventos): Eventos da loja (pedido pago, reembolso, assinatura…), do mais novo ao mais antigo.
      - [Ver evento](/api/referencia/eventos/ver-evento): Devolve o evento com o mesmo corpo enviado aos webhooks.
    - Gift cards
      - [Alterar gift card](/api/referencia/gift-cards/alterar-gift-card): Altera validade ou desativa o gift card.
      - [Criar gift card](/api/referencia/gift-cards/criar-gift-card): Cria um gift card com saldo e, se quiser, manda por e-mail.
      - [Criar gift cards em lote](/api/referencia/gift-cards/criar-gift-cards-em-lote): Cria vários gift cards de uma vez.
      - [Listar gift cards](/api/referencia/gift-cards/listar-gift-cards): Gift cards da loja com saldo.
      - [Recarregar gift card](/api/referencia/gift-cards/recarregar-gift-card): Adiciona saldo a um gift card.
      - [Reenviar gift card](/api/referencia/gift-cards/reenviar-gift-card): Manda de novo o e-mail com o código do gift card.
      - [Ver gift card](/api/referencia/gift-cards/ver-gift-card): Devolve o gift card com saldo e usos.
    - Imagens
      - [Apagar imagem](/api/referencia/imagens/apagar-imagem): Apaga a imagem. Produtos que usavam ficam sem ela.
      - [Enviar imagem](/api/referencia/imagens/enviar-imagem): Envia uma imagem (até 2 MB, em base64) para usar em produtos e na vitrine.
      - [Listar imagens](/api/referencia/imagens/listar-imagens): Imagens enviadas pela loja.
    - Links de pagamento
      - [Alterar link de pagamento](/api/referencia/links-de-pagamento/alterar-link-de-pagamento): Altera só os campos enviados do link.
      - [Arquivar link de pagamento](/api/referencia/links-de-pagamento/arquivar-link-de-pagamento): Desativa o link; quem abrir vê que ele não está mais disponível.
      - [Criar link de pagamento](/api/referencia/links-de-pagamento/criar-link-de-pagamento): Cria um link com produtos e quantidades. Único (paga uma vez) ou fixo (paga várias vezes).
      - [Listar links de pagamento](/api/referencia/links-de-pagamento/listar-links-de-pagamento): Links de pagamento da loja.
      - [Ver link de pagamento](/api/referencia/links-de-pagamento/ver-link-de-pagamento): Devolve o link com os pedidos que ele gerou.
    - Meta da comunidade
      - [Configurar meta da comunidade](/api/referencia/meta-da-comunidade/configurar-meta-da-comunidade): Define o valor, o ciclo e o que acontece quando a meta é batida.
      - [Metas batidas](/api/referencia/meta-da-comunidade/metas-batidas): Histórico das vezes em que a meta foi batida.
      - [Ver meta da comunidade](/api/referencia/meta-da-comunidade/ver-meta-da-comunidade): Meta de vendas do mês, progresso e ações ao bater.
    - Pagamentos
      - [Ligar ou desligar cartão](/api/referencia/pagamentos/ligar-ou-desligar-cartao): Liga ou desliga o pagamento com cartão no checkout.
      - [Listar meios de pagamento](/api/referencia/pagamentos/listar-meios-de-pagamento): Meios de pagamento da loja e se cada um está ativo.
      - [Listar pagamentos](/api/referencia/pagamentos/listar-pagamentos): Pagamentos recebidos, com meio (Pix, cartão, boleto), taxa e valor líquido.
      - [Ver pagamento](/api/referencia/pagamentos/ver-pagamento): Devolve um pagamento.
    - Pedidos
      - [Cancelar pedido](/api/referencia/pedidos/cancelar-pedido): Cancela um pedido ainda não pago; o link de pagamento deixa de funcionar.
      - [Criar pedido](/api/referencia/pedidos/criar-pedido): Cria um pedido com produtos do catálogo. Mande o comprador para o `checkoutUrl` da resposta para pagar. Use `Idempotency-Key` para não duplicar.
      - [Devolver em gift card](/api/referencia/pedidos/devolver-em-gift-card): Devolve o valor do pedido como saldo num gift card, em vez de reembolsar.
      - [Gift cards usados no pedido](/api/referencia/pedidos/gift-cards-usados-no-pedido): Gift cards que pagaram parte ou todo o pedido.
      - [Listar pedidos](/api/referencia/pedidos/listar-pedidos): Lista os pedidos da loja, do mais novo ao mais antigo, com filtro por status e cliente.
      - [Reenviar e-mail do pedido](/api/referencia/pedidos/reenviar-e-mail-do-pedido): Manda de novo o recibo ao comprador, com chaves e links de download.
      - [Registrar pedido manual](/api/referencia/pedidos/registrar-pedido-manual): Registra uma venda feita fora da Rivoo e roda as entregas dos produtos, sem cobrar.
      - [Ver pedido](/api/referencia/pedidos/ver-pedido): Devolve o pedido com itens, pagamentos, reembolsos e entregas.
    - Preços
      - [Alterar preço](/api/referencia/precos/alterar-preco): Altera ou desativa um preço. Assinaturas existentes mantêm o valor contratado.
      - [Criar preço](/api/referencia/precos/criar-preco): Adiciona um preço ao produto, em centavos, avulso ou recorrente.
      - [Listar preços](/api/referencia/precos/listar-precos): Preços do produto: avulso e de assinatura (mensal, trimestral…).
    - Produtos
      - [Alterar produto](/api/referencia/produtos/alterar-produto): Altera só os campos enviados do produto.
      - [Arquivar produto](/api/referencia/produtos/arquivar-produto): Tira o produto da vitrine. Pedidos e benefícios já entregues não mudam.
      - [Criar produto](/api/referencia/produtos/criar-produto): Cria um produto com preço em centavos, imagem, descrição e regras de compra.
      - [Definir ofertas do produto](/api/referencia/produtos/definir-ofertas-do-produto): Substitui os produtos oferecidos junto no checkout.
      - [Definir requisitos do produto](/api/referencia/produtos/definir-requisitos-do-produto): Substitui a lista de pacotes exigidos ou proibidos para comprar este produto.
      - [Listar produtos](/api/referencia/produtos/listar-produtos): Lista os produtos da loja, com busca e filtro por categoria.
      - [Ordenar produtos](/api/referencia/produtos/ordenar-produtos): Define a ordem dos produtos dentro da categoria pela lista de ids enviada.
      - [Ver ofertas do produto](/api/referencia/produtos/ver-ofertas-do-produto): Produtos oferecidos junto no checkout quando este está no carrinho.
      - [Ver produto](/api/referencia/produtos/ver-produto): Devolve um produto com preços, regras e ações de entrega.
      - [Ver requisitos do produto](/api/referencia/produtos/ver-requisitos-do-produto): Pacotes que o comprador precisa ter (ou não ter) para comprar este produto.
    - Recuperação de carrinho
      - [Configurar recuperação de carrinho](/api/referencia/recuperacao-de-carrinho/configurar-recuperacao-de-carrinho): Liga, desliga e ajusta o lembrete de carrinho abandonado e o agradecimento pós-compra.
      - [Números da recuperação](/api/referencia/recuperacao-de-carrinho/numeros-da-recuperacao): Lembretes enviados, pedidos recuperados e valor recuperado no mês.
      - [Ver recuperação de carrinho](/api/referencia/recuperacao-de-carrinho/ver-recuperacao-de-carrinho): Devolve o lembrete de carrinho abandonado e o agradecimento pós-compra, com os cupons de cada um.
    - Reembolsos
      - [Informar destino do reembolso](/api/referencia/reembolsos/informar-destino-do-reembolso): Informa a chave Pix para onde devolver quando o pagamento original não permite devolução automática.
      - [Listar reembolsos](/api/referencia/reembolsos/listar-reembolsos): Todos os reembolsos da loja.
      - [Reembolsar pedido](/api/referencia/reembolsos/reembolsar-pedido): Reembolsa todo ou parte do pedido. O benefício entregue é retirado quando o produto tem ação de reembolso.
      - [Reembolsos do pedido](/api/referencia/reembolsos/reembolsos-do-pedido): Reembolsos feitos no pedido.
    - Relatórios
      - [Conversão](/api/referencia/relatorios/conversao): Pedidos criados, pagos e a taxa de conversão no período.
      - [Melhores clientes](/api/referencia/relatorios/melhores-clientes): Clientes que mais gastaram no período.
      - [Produtos mais vendidos](/api/referencia/relatorios/produtos-mais-vendidos): Produtos com mais receita no período.
      - [Resumo de vendas](/api/referencia/relatorios/resumo-de-vendas): Vendas, receita, ticket médio e reembolsos no período.
      - [Vendas por dia](/api/referencia/relatorios/vendas-por-dia): Série de vendas e receita por dia no período.
    - Servidores
      - [Adicionar servidor por RCON](/api/referencia/servidores/adicionar-servidor-por-rcon): Liga um servidor pelo RCON, sem instalar nada nele (beta).
      - [Adicionar servidor](/api/referencia/servidores/adicionar-servidor): Cria a conexão de um servidor e devolve a chave que vai no plugin.
      - [Alterar servidor por RCON](/api/referencia/servidores/alterar-servidor-por-rcon): Altera endereço, porta ou senha do RCON.
      - [Alterar servidor](/api/referencia/servidores/alterar-servidor): Altera só os campos enviados do servidor.
      - [Confirmar pareamento](/api/referencia/servidores/confirmar-pareamento): Liga à loja o servidor que mostrou o código no console.
      - [Listar servidores](/api/referencia/servidores/listar-servidores): Servidores de jogo ligados à loja (plugin ou agente) e se estão online.
      - [Remover servidor](/api/referencia/servidores/remover-servidor): Desliga o servidor da loja; a chave para de funcionar.
      - [Trocar chave do servidor](/api/referencia/servidores/trocar-chave-do-servidor): Gera uma chave nova e invalida a antiga.
      - [Ver pareamento](/api/referencia/servidores/ver-pareamento): Mostra o servidor que pediu pareamento com o código exibido no console.
      - [Ver servidor](/api/referencia/servidores/ver-servidor): Devolve o servidor com o último contato.
    - Vitrine
      - [Alterar vitrine salva](/api/referencia/vitrine/alterar-vitrine-salva): Altera só os campos enviados da vitrine.
      - [Apagar vitrine salva](/api/referencia/vitrine/apagar-vitrine-salva): Apaga uma vitrine que não está no ar.
      - [Criar vitrine](/api/referencia/vitrine/criar-vitrine): Cria uma vitrine a partir de um template.
      - [Duplicar vitrine](/api/referencia/vitrine/duplicar-vitrine): Cria uma cópia da vitrine para editar sem mexer na original.
      - [Exportar vitrine](/api/referencia/vitrine/exportar-vitrine): Baixa a vitrine num arquivo para importar em outra loja.
      - [Importar vitrine](/api/referencia/vitrine/importar-vitrine): Cria uma vitrine a partir de um arquivo exportado.
      - [Link de prévia da vitrine salva](/api/referencia/vitrine/link-de-previa-da-vitrine-salva): Gera um link temporário para ver esta vitrine antes de publicar.
      - [Link de prévia](/api/referencia/vitrine/link-de-previa): Gera um link temporário para ver o rascunho como o comprador verá.
      - [Listar vitrines](/api/referencia/vitrine/listar-vitrines): Vitrines da loja (temas salvos), com a que está no ar marcada.
      - [Publicar vitrine salva](/api/referencia/vitrine/publicar-vitrine-salva): Coloca esta vitrine no ar no lugar da atual.
      - [Publicar vitrine](/api/referencia/vitrine/publicar-vitrine): Publica o rascunho atual; a loja muda na hora.
      - [Salvar rascunho da vitrine](/api/referencia/vitrine/salvar-rascunho-da-vitrine): Salva o rascunho da vitrine sem publicar.
      - [Ver vitrine salva](/api/referencia/vitrine/ver-vitrine-salva): Devolve uma vitrine salva.
      - [Ver vitrine](/api/referencia/vitrine/ver-vitrine): Rascunho e versão publicada da vitrine da loja.
    - Webhooks
      - [Alterar webhook](/api/referencia/webhooks/alterar-webhook): Altera URL, eventos ou pausa o envio.
      - [Apagar webhook](/api/referencia/webhooks/apagar-webhook): Para de enviar eventos para a URL.
      - [Criar webhook](/api/referencia/webhooks/criar-webhook): Cadastra uma URL e os eventos que ela recebe. O segredo de assinatura aparece só nesta resposta.
      - [Envios do webhook](/api/referencia/webhooks/envios-do-webhook): Tentativas de envio para a URL, com o código de resposta de cada uma.
      - [Listar webhooks](/api/referencia/webhooks/listar-webhooks): Endereços que recebem os eventos da loja.
      - [Testar webhook](/api/referencia/webhooks/testar-webhook): Envia um evento de teste para a URL.
      - [Trocar segredo do webhook](/api/referencia/webhooks/trocar-segredo-do-webhook): Gera um segredo de assinatura novo. O antigo continua valendo por 24 horas, para você trocar sem perder eventos.
      - [Ver webhook](/api/referencia/webhooks/ver-webhook): Devolve o webhook com os eventos assinados.
- Webhooks
  - [Webhooks](/webhooks): Receba no seu servidor cada venda, reembolso, disputa e assinatura, na hora em que acontece.
  - Eventos
    - [order.created](/webhooks/eventos/order.created): Um pedido foi criado (pela vitrine, API, link de pagamento, plugin, Discord, assinatura ou à mão).
    - [order.updated](/webhooks/eventos/order.updated): Um pedido em aberto mudou de itens ou de cupom antes do pagamento; o total foi recalculado.
    - [order.paid](/webhooks/eventos/order.paid): O pagamento do pedido foi confirmado.
    - [order.expired](/webhooks/eventos/order.expired): O prazo para pagar acabou sem pagamento.
    - [order.canceled](/webhooks/eventos/order.canceled): Um pedido em aberto foi cancelado antes do pagamento.
    - [order.refunded](/webhooks/eventos/order.refunded): O valor pago foi devolvido por inteiro.
    - [order.partially_refunded](/webhooks/eventos/order.partially_refunded): Parte do valor pago foi devolvida.
    - [payment.succeeded](/webhooks/eventos/payment.succeeded): Um pagamento (Pix, cartão ou boleto) foi aprovado e pagou o pedido.
    - [refund.succeeded](/webhooks/eventos/refund.succeeded): O dinheiro chegou de volta ao comprador.
    - [refund.failed](/webhooks/eventos/refund.failed): Não foi possível devolver o dinheiro.
    - [dispute.opened](/webhooks/eventos/dispute.opened): O comprador contestou o pagamento: MED no Pix ou chargeback no cartão.
    - [dispute.closed](/webhooks/eventos/dispute.closed): A disputa terminou.
    - [payout.paid](/webhooks/eventos/payout.paid): O saque caiu na conta do titular.
    - [payout.failed](/webhooks/eventos/payout.failed): O saque não foi concluído e o valor voltou ao saldo.
    - [subscription.created](/webhooks/eventos/subscription.created): Uma assinatura foi criada, junto com o primeiro pedido dela.
    - [subscription.renewed](/webhooks/eventos/subscription.renewed): A cobrança de um novo período foi paga.
    - [subscription.past_due](/webhooks/eventos/subscription.past_due): O período acabou sem a renovação paga.
    - [subscription.canceled](/webhooks/eventos/subscription.canceled): A assinatura foi cancelada.
    - [subscription.ended](/webhooks/eventos/subscription.ended): A assinatura acabou de vez e os benefícios foram retirados.
    - [entitlement.created](/webhooks/eventos/entitlement.created): O comprador ganhou um benefício (rank, VIP, item) por uma compra ou renovação.
    - [entitlement.ended](/webhooks/eventos/entitlement.ended): Um benefício acabou.
    - [entitlement.restored](/webhooks/eventos/entitlement.restored): Um benefício encerrado voltou a valer (ex.: disputa ganha, ou rank anterior devolvido quando o upgrade foi reembolsado).
    - [delivery.failed](/webhooks/eventos/delivery.failed): Um comando não pôde ser executado no servidor do jogo.
- IA
  - [IA](/ia): Use a Rivoo com o Claude, o ChatGPT, o Cursor ou seu próprio agente.
  - [MCP](/ia/mcp): Conecte o Claude, o ChatGPT ou o Cursor à sua loja para consultar vendas, pedidos e clientes.
  - [Markdown e llms.txt](/ia/llms): Como uma IA lê esta documentação.
- Referência rápida
  - [Variáveis de comando](/referencia-rapida/variaveis-de-comando): O que você pode usar nos comandos de entrega, como {player} e {transaction}.
  - [Status de pedido](/referencia-rapida/status-de-pedido): O que cada status de pedido quer dizer.
  - [Glossário](/referencia-rapida/glossario): Os termos que aparecem no painel e na API.
  - [Changelog](/referencia-rapida/changelog): O que mudou na API e na documentação.