# Coinpayments

* [Как подключить](#podklyuchenie) link How to connect
* [Как сформировать ссылку на оплату](#kak-sformirovat-ssylku-na-oplatu) link How to generate a payment link
* [Как обработать результат](#obrabotka-rezultata) link How to process the result
* [Как проверить статус платежа](#proverka-statusa-platezha) link How to check the payment status

## Como conectar

Para conectar o sistema de pagamento Coinpayments, você precisará de quatro valores: o ID do vendedor, o segredo do IPN (para webhooks), a chave privada da API e a chave pública da API. Você também precisará definir a URL do webhook.

Acesse a conta pessoal do Coinpayments -> Configurações da conta <https://www.coinpayments.net/index.php?cmd=acct_settings>

![](https://lh3.googleusercontent.com/xACTDovKtHxhj7vrWkS0u2TpAy_mK1VU7fR7k2KAD_6lL9OHyKsn4Np54iD4jb7Gjackry858WfaABz37i6tkfn5HZW94n4SKqDq3ooRToxaeXQPRbhvgnKG-KrAssSlHy2lrSSQ)

Na primeira aba, copie o ID do vendedor. (**ID do vendedor**)

![](/files/3b2cf2cd258a7d61aa5a5014f377eb02e1ea5101)

Em seguida, vá para a aba "Seller Settings" e crie e insira uma chave secreta IPN - **segredo IPN** ( Isso é usado para verificar se o webhook está vindo de nós). Use uma string segura e complexa, difícil de adivinhar

O link IPN - é a URL para webhooks, adicione o seguinte: **<https://chatter.salebot.pro/coinpayments\\_callback/result>**

![](https://lh6.googleusercontent.com/K939LTpXmntuJKU1tTN6NTBgl2ziiQTG7okWMRAdOMMQa0K7LbH0X3l7FWmd74FPqY9NOOGl89tbK99fgCpFLva4NJ8VVZVwwGfaE9YYKQ5EOkkb72Qz3FO5jPisxWxrAX8Ac94p)

Em seguida, vá para a seção API Keys e gere um par de chaves para acessar a API.

![](https://lh6.googleusercontent.com/4Y9V4YRgYAvMJNelxlO5bhynVt1er0a5F-QNnOitbBrWFfOLPwJpOM8BHKgMcXxlKzwE9rc32Coxo-iVB_kvGRrgf0XXEjSsop5Uic8CP-8ey8Ll7a_CkvB7D3tcpcEgUo0Dbz7N)

Salve todas as configurações, copie os dados e vá para as configurações no Mavibot. Abra a seção "Acquiring", selecione Coinpayments.

<figure><img src="/files/cc634bd0259f7f706d396c4afe94c367ea54629f" alt=""><figcaption></figcaption></figure>

Você precisa inserir os dados recebidos.

<figure><img src="/files/5a5677371c53da455f58753e05e70b68e6b8c641" alt="" width="563"><figcaption></figcaption></figure>

Para gerar um link de pagamento, você precisa definir o valor das variáveis necessárias:

<table><thead><tr><th width="201">Variáveis</th><th width="228">Valor da variável</th><th>Observação</th></tr></thead><tbody><tr><td> <strong>original_currency</strong> </td><td>A moeda original da transação.</td><td></td></tr><tr><td><strong>sending_currency</strong></td><td>A moeda que o cliente irá enviar.</td><td>Por exemplo, se seus produtos estão precificados em USD, mas você recebe BTC, você deve usar original_currency = USD e sending_currency = BTC. original_currency e sending_currency podem ter o mesmo valor se a conversão de moeda não for necessária.</td></tr><tr><td><strong>buyer_email</strong> </td><td>Endereço de e-mail do cliente.</td><td>Para enviar notificações se o pagamento for de um valor menor e precisar ser complementado, ou para reembolsos. Se essa variável não for definida, o e-mail será obtido automaticamente da variável email, se o usuário tiver uma no Mavibot.</td></tr></tbody></table>

Depois disso, você precisa definir o valor da **payment\_sum** variável (por exemplo, 10 ou 0.0055 **(separado por ponto!)),** e a **coinpayments\_pay\_url** variável aparecerá imediatamente depois disso. Essa variável pode ser exibida com um link ou colocada em um botão com o texto "Pagar". O link parece com este: **<https://www.coinpayments.net/index.php?cmd=checkout\\&id=CPFK5QZ3FKSNWHI75CO8M4BRVD\\&key=e7782d2ce24f7d03815606a5c4a882eb>**

Além disso, antes de definir o valor da variável payment\_sum, você pode definir as seguintes variáveis opcionais para configurar o pagamento.

**payment\_description** - o nome do produto estará na página de informações de pagamento e no IPN da transação.

**buyer\_name** - nome do cliente

É assim que a página de pagamento se parece.

![](https://lh3.googleusercontent.com/Yn1a6_JOW4wkj2SqNwkkJYMBZoh4JcR1HEinzP67O6WmYBcCV3IdRw_JCEQI0L7OV-8IuH_JdMEdOaduymc0vs5QAmpfcgrU0tFD9ZrT6V_B8vvQqe-sQcUDMsd9PJRa_uUsJAsX)

## Como gerar um link de pagamento

Crie um link de pagamento no valor de 0.0256

<figure><img src="/files/60fad7d61d35f79a00e106d3c44331e92f47c316" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Atenção:** \
\- Primeiro, especifique o endereço de e-mail\
\- Depois, parâmetros opcionais  **first\_name, payment\_description** e etc.\
\- Por fim, atribua um valor à **payment\_sum** variável.
{% endhint %}

Observe que primeiro definimos as variáveis para as configurações, depois **payment\_sum.** As variáveis podem ser definidas antes na cadeia, em vez de em um único bloco; este é um exemplo.

Em seguida, exibimos a **coinpayments\_pay\_url** variável no lugar certo, que contém o link

<figure><img src="/files/c3a18c574d43e45bcc44215bdfe1d4bbaba4e2af" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
Para fazer um pagamento repetido, você precisa redefinir payment\_sum, o link gerado anteriormente, e então atribuir novamente a variável payment\_sum para obter um link novo.
{% endhint %}

## Como processar o resultado

Após um pagamento bem-sucedido, callbacks serão enviados ao bot, o que permitirá que você saiba que o pagamento foi concluído com sucesso. Você vê esses callbacks no sistema como mensagens do usuário. Para impedir que o usuário os envie, eles consistem nos primeiros 10 caracteres da chave secreta e no pós-escrito \_success, por exemplo: **16831CF4b5\_success**

{% hint style="success" %}
Esses callbacks NÃO SÃO VISÍVEIS PARA o usuário, eles são exibidos apenas para o operador.
{% endhint %}

{% hint style="danger" %}
O tipo de comparação deve ser "Correspondência completa"
{% endhint %}

Além disso, após o pagamento bem-sucedido, a variável coinpayments\_payment\_completed é definida como True.

Por exemplo, você pode processar um pagamento bem-sucedido em um bloco condicional e exibir a mensagem correspondente ao usuário:

<figure><img src="/files/e26efcdf483ddd0a83cf952e31693db31ec74fe5" alt=""><figcaption></figcaption></figure>

Após a conclusão do pagamento, a variável **coinpayments\_payment\_callback** a variável será adicionada ao cliente, contendo os dados da resposta do sistema de pagamento para a transação concluída. Você pode extrair os dados necessários do dicionário resultante usando o **get** .

## Como verificar o status do pagamento

Para verificar o status do pagamento, use **coinpayments\_get\_payment\_status()** método no campo Calculator.

Exemplo:

<figure><img src="/files/34fa380290e4a2e520debd260178283bf9610fd0" alt="" width="563"><figcaption></figcaption></figure>

> **Exemplo de status**:
>
> Aguardando fundos do comprador...
>
> Fundos recebidos e confirmação do envio para você em breve…
>
> Concluído


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/pagamento/coinpayments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.