Incorpore o checkout no seu site

Da fatura ao checkout#

Crie uma fatura em /account#links e receba imediatamente checkoutUrl. Abra /account#widget, cole o link e escolha um modal, bloco inline ou redirecionamento. Chaves e webhooks estão disponíveis nas seções vizinhas da conta.

A pré-visualização do construtor sempre usa um pedido de demonstração sem cobrar. O código do widget gerado mantém seu link ativo, cujos termos vêm da fatura salva no servidor.

Para uma nova fatura na interface, USD oferece cartões e Alipay; RUB oferece SBP; USDT oferece criptomoeda. A API também pode salvar USD + criptomoeda para compatibilidade, mas seu pagamento cripto ao vivo é bloqueado com crypto_requires_usdt. USD e USDT são distintos, sem conversão automática nem taxa presumida de 1:1. Um pagamento cripto exige uma fatura USDT separada.

Um botão com fallback de link normal#

Este exemplo abre uma demonstração sem cobrar dinheiro. Substitua ambos os valores de URL por checkoutUrl da resposta da sua fatura. Carregue o script da mesma origem Kevmi que a URL de checkout.

O href abre o checkout quando o JavaScript está indisponível. data-kevmi-label dá ao iframe um nome acessível. Inclua o script uma vez por página.

<script src="https://kevmi.maxeevmax1.chatgpt.site/widgets/kevmi.js" defer></script>
<a href="https://kevmi.maxeevmax1.chatgpt.site/en/pay/demo"
   data-kevmi-checkout="https://kevmi.maxeevmax1.chatgpt.site/en/pay/demo"
   data-kevmi-mode="modal"
   data-kevmi-label="Order checkout">Pay securely</a>

Três maneiras de abrir o checkout#

Use um contêiner como div para o modo inline e substitua CHECKOUT_URL_FROM_API por uma URL real. O quadro se adapta à largura do contêiner; as mensagens de checkout podem redimensionar sua altura dentro de um intervalo limitado.

O modal fecha com seu botão, Escape ou clique no fundo. O foco retorna ao gatilho original após fechar. As configurações de movimento reduzido encurtam a transição.

<div data-kevmi-checkout="CHECKOUT_URL_FROM_API"
     data-kevmi-mode="inline"
     data-kevmi-label="Order checkout"></div>

Abra o checkout a partir da sua interface#

Os eventos de documento kevmi:opened e kevmi:closed permitem que sua interface reaja à abertura e ao fechamento. Um evento kevmi:error no gatilho relata uma URL de checkout inválida. Nenhum deles comprova pagamento. Chame a API JavaScript depois que o script do widget tiver sido carregado.

window.Kevmi.open(checkoutUrl, {
  mode: 'modal',
  label: 'Order checkout',
  closeLabel: 'Close checkout'
});

// Inline blocks added after page load are detected automatically.
// You may also request mounting explicitly:
window.Kevmi.mount(document);

O que comprova um pagamento bem-sucedido#

Não coloque chaves de API ou segredos de assinatura em HTML. O widget recebe apenas um link público para uma fatura. O checkout criptografa os dados do cartão e os códigos bancários com a chave do gateway; o servidor Kevmi não os aceita em texto simples.

postMessage atualiza o estado da interface, não a execução do pedido. Verifique a origem da mensagem e a janela de origem antes de processar. Use um evento verificado payment.succeeded ou um status succeeded no resumo GET link.payment do servidor para o resultado final.

Antes de adicionar o widget à produção#

• Permita a origem Kevmi nas diretivas Content Security Policy script-src e frame-src sem ampliar políticas não relacionadas.
• Verifique telas estreitas, acesso por teclado e temas claro e escuro.
• Confirme que a fatura está ativa, não expirada e com o preço e as cotas de custo corretos.
• Mantenha um link de pagamento comum como fallback.
• Teste entregas com falha e eventos de webhook duplicados sem emitir um pedido duas vezes.