> For the complete documentation index, see [llms.txt](https://support.trybit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.trybit.com/pt-br/integration/html-widget.md).

# Widget de Pagamento HTML

Integração da Trybit via um widget HTML.

Para começar a integrar, você precisa criar um projeto no seu painel da Trybit e obter uma chave de API e um Shop ID — esses dados são necessários para configurar a interação entre o seu sistema e a plataforma, e para autorizar solicitações.

O **widget HTML** é um formulário de pagamento pronto que você pode instalar no seu site sem integração com API e sem um desenvolvedor. O cliente simplesmente escolhe uma moeda, insere o valor e o e-mail — o pagamento acontece em uma janela incorporada (iframe), sem redirecionamento para uma página separada. Você receberá notificações de pagamento no seu painel, por e-mail, no Telegram e via POSTBACK, se necessário.

<figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FpQZOX0ARJEcm18e4c3hV%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-10-15%20%D0%B2%2014.11.38.png?alt=media&amp;token=d4da5a83-a894-439c-ac10-5847a0d5d295" alt=""><figcaption></figcaption></figure>

### Como configurar o widget

Configure o widget nas configurações do projeto, em "Widget de Pagamento."

1. Escolha o design e o texto do botão ou do formulário.
2. Para um botão, você precisa definir um valor fixo de pagamento. Em um formulário, o cliente pode inserir o valor por conta própria.
3. Escolha o idioma do widget.
4. Ative ou desative o campo de e-mail do cliente nas configurações do formulário HTML.
5. Salve as configurações e copie o código gerado.

### Como adicionar o formulário ou botão ao seu site

O widget pode ser instalado usando um dos dois métodos — escolhidos no mesmo construtor:

* [Formulário HTML](https://docs.trybit.com/buttons-forms/html-widget/form) — o widget é exibido imediatamente como um bloco incorporado na página;
* [Botão HTML](https://docs.trybit.com/buttons-forms/html-widget/button) — apenas um botão é exibido na página, e o formulário de pagamento é aberto ao clicar.

<figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2F0gCLZmEjC8SEShcpzmJZ%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-10-15%20%D0%B2%2016.33.02.png?alt=media&amp;token=997dab64-3873-45c5-8c38-f02ae4a9d3ed" alt=""><figcaption></figcaption></figure>

O código gerado é inserido no código da página do seu site.

Você pode ler mais sobre o widget HTML na [esta seção](https://docs.trybit.com/buttons-forms/html-widget).

### Onde colocar o link permanente

O mesmo construtor também permite obter não apenas o código incorporável, mas também um link permanente para uma página de pagamento separada com as mesmas configurações — sem precisar incorporar qualquer código no seu site. Esse link é conveniente para colocar onde não seja possível inserir código HTML:

* em um canal do Telegram;
* na descrição de um perfil em rede social;
* em uma newsletter por e-mail;
* em uma landing page ou em um anúncio.

{% hint style="success" %}
Se você tiver alguma dúvida ou precisar de ajuda, você pode contatar nosso suporte via chat no site e na sua conta pessoal, além de falar conosco no Telegram. Os contatos de suporte estão listados [no nosso site](https://trybit.com/support).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.trybit.com/pt-br/integration/html-widget.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
