Configurações da loja

Nome da loja#

Escolha um nome curto e reconhecível que seu cliente espera ver no pedido. O nome deve conter de 1 a 80 caracteres após remover espaços nas bordas.

Um nome de exibição não substitui os dados legais nem o acordo com o cliente. Mantenha segredos, credenciais de pagamento e informações pessoais de outras pessoas fora deste campo.

Contribuinte de IVA#

O pagador padrão é o cliente. O IVA se aplica apenas a cartões e Alipay. Alterar a configuração não muda os totais de SBP ou criptomoedas.

Faturas existentes mantêm seus termos salvos. Ao criar uma fatura, o IVA do cliente e as participações de taxas de 0 a 100% podem substituir os padrões. A preferência da loja apenas fornece um padrão para faturas futuras.

Uma preferência salva não expande os recursos do gateway. Os canais atuais de cartão e Alipay exigem 100% de IVA do cliente e 0% de taxa de processamento do cliente; outras alocações salvas permanecem como cálculos.

Notificações do Telegram#

Selecione as categorias de pagamento, pagamentos, suporte e segurança. Escolher uma categoria controla as notificações; não ativa um canal de pagamento nem gera eventos financeiros.

Uma mensagem de teste verifica a entrega no chat privado vinculado. O status aparece no centro de notificações e em GET /api/notifications. Uma mensagem na fila ainda não foi entregue; verifique também o Telegram.

Salvar e erros#

O formulário confirma um salvamento concluído. Se a rede falhar, sua entrada permanece disponível para uma nova tentativa; pressionar Salvar sozinho não prova que a alteração foi armazenada.

Entre novamente quando sua sessão expirar. O servidor identifica a conta pela sessão e não aceita outro ID de proprietário de loja vindo do navegador.

Tema e dados de demonstração#

O tema de exibição é salvo localmente no dispositivo. O espaço de trabalho de demonstração usa dados de navegador separados e não altera a conta do servidor.

Redefinir a demonstração remove apenas os registros de teste nesse navegador. Uma exportação de demonstração não é um extrato bancário nem uma prova de pagamento.

Múltiplas lojas e um preço base em USD#

Escolha Todas as lojas para análises e operações agregadas, ou selecione uma loja para seus próprios registros. Cada loja tem um storeId separado, nome, padrão de IVA, faturas, chaves de API, endpoints de webhook, histórico de eventos e aplicativo de site. Notificações e tickets de suporte pertencem à conta. Uma conta pode criar até 100 lojas. Registros existentes permanecem na primeira loja.

As faturas do novo workspace usam pricingMode="universal" e um preço base em USD. O plano Any inclui cartão, alipay, sbp e cripto; um comerciante pode selecionar um subconjunto. Cartões e Alipay cobram em USD. O SBP cobra em RUB usando a taxa de referência USD/RUB do Banco da Rússia. Cripto cobra USDT sob a regra explícita de fatura 1 USD = 1 USDT. Esta é uma regra de conversão de fatura, não uma cotação de mercado de USDT. O gateway fornece a taxa da moeda selecionada, o valor exato da transferência e instruções antes da transferência.

A taxa de referência e ambos os valores são congelados na criação. Faturas que envolvem conversão RUB expiram dentro de 24 horas. Se a taxa de referência não puder ser obtida, a criação falha com FX_UNAVAILABLE; nenhuma taxa de fallback inventada ou desatualizada é usada. O valor do proprietário em minor e cotações usam a moeda contábil USD. quotes[method].settlement contém a cotação de cobrança nativa. O checkout público expõe a moeda de cobrança selecionada em currency, o preço original em baseAmountMinor/baseCurrency, e a taxa de referência em fx. Uma vez que um pagamento foi enviado, seu método não pode ser alterado; uma fatura tem uma operação de gateway.

Crie uma chave de API dentro da loja pretendida e envie Authorization: Bearer <key> do seu servidor. Seu vínculo de loja é imutável; X-Kevmi-Store não pode conceder acesso a outra loja. Sessões de navegador selecionam X-Kevmi-Store: <storeId>; omitir seleciona a primeira loja. O valor all é aceito apenas por GET /api/account/dashboard e GET /api/payment-links. Mutações exigem uma loja selecionada, Origin e X-CSRF-Token. IDs de conta e IDs de loja são identificadores diferentes.

Para compatibilidade, solicitações de API sem pricingMode="universal" mantêm preço nativo e as restrições originais de moeda. Faturas existentes nunca são recalculadas. Recibos confirmados nas análises refletem pagamentos verificados menos despesas de fatura salvas; eles não são um saldo sacável. Moedas de fatura legadas permanecem separadas e pagamentos são combinados com o suporte. Cumpra um pedido somente após verificar payment.fulfillmentReady=true e payment.status="succeeded" através da API do servidor, histórico de eventos ou um webhook assinado.