# Paytabs

## Conectando o PayTabs ao Mavibot

Para conectar o PayTabs ao Mavibot, você precisa configurar várias definições na sua conta PayTabs.

### 1. Criar uma chave de API

No seu painel do PayTabs, vá para:

**Desenvolvedores → Chaves de API**

Crie uma nova chave de API.

<div data-with-frame="true"><img src="/files/e770da1a3ab0edd5bb64cfed432d8ecd644a6c68" alt=""></div>

<div data-with-frame="true"><img src="/files/36caaa3f40ae6eaddb1a6a27450174fb48599cb6" alt=""></div>

Após criar a chave de API, salve os seguintes detalhes:

* **Chave do servidor** — necessária para configurar a integração.
* **ID do perfil** — também necessário para a configuração da conexão.

<div data-with-frame="true"><img src="/files/783ebebf01323bd6ab64b01ac5b7dbfda53d19a2" alt="" height="252" width="794"></div>

### 2. Configurar notificações de pagamento

Vá para:

**Desenvolvedores → Configuração**

<div data-with-frame="true"><img src="/files/b62bc9bbf4b7f168e13c6b644834bbb5dbeb0d71" alt="" height="414" width="750"></div>

Ative as notificações de pagamento (**callbacks**).

Clique **"+"** e adicione a seguinte URL de callback:

```
https://chatter.mavibot.ai/paytabs_callback/result
```

<div data-with-frame="true"><img src="/files/51497e4dd62e33d979cdab269f3a8c41056b699f" alt="" height="322" width="822"></div>

<div data-with-frame="true"><img src="/files/b97faae1e6ab90e140b7f168fc0ce681d386763d" alt="" height="368" width="835"></div>

Esta URL é usada para enviar atualizações de status de pagamento ao Mavibot.

### 3. Configurar o PayTabs no Mavibot

<div data-with-frame="true"><figure><img src="/files/5914e2947e95a759cb41bc1221ebecea7c801b90" alt=""><figcaption></figcaption></figure></div>

Nas configurações do Mavibot:

1. Vá para a **Aquisição** seção
2. Selecione **PayTabs** como provedor de pagamento
3. Insira os seguintes detalhes:
   * **ID do perfil**
   * **Chave do servidor**
4. Selecione sua **região da conta PayTabs**

{% hint style="info" %}
**Atenção!**\
A região selecionada deve corresponder à região em que sua conta PayTabs está registrada.
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/7a0410c869f8be4b03d0899e030469ed50dad6db" alt="" width="563"><figcaption></figcaption></figure></div>

Depois que as configurações forem salvas, a configuração da integração estará concluída.

### Gerando um link de pagamento

Para gerar um link de pagamento, use a seguinte função:

`get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone,    full_name, language)`

#### Parâmetros da função

| Parâmetro                                        | Descrição                                         |
| ------------------------------------------------ | ------------------------------------------------- |
| <mark style="color:$danger;">**!**</mark> amount | Valor do pagamento. Parâmetro obrigatório         |
| description                                      | Descrição do pagamento. Parâmetro opcional        |
| currency                                         | Moeda do pagamento. Parâmetro opcional            |
| customer\_email                                  | Endereço de e-mail do cliente. Parâmetro opcional |
| customer\_phone                                  | Número de telefone do cliente. Parâmetro opcional |
| full\_name                                       | Nome completo do cliente. Parâmetro opcional      |
| language                                         | Idioma da página de pagamento. Parâmetro opcional |

#### Moedas disponíveis

Os seguintes códigos de moeda são suportados:

```
SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD
```

#### Idiomas disponíveis

```
en — Inglêsar — Árabefr — Francês
```

A função retorna uma URL de pagamento.

Se o **currency** parâmetro não for fornecido, a moeda será selecionada automaticamente com base na região configurada.

### Usando o link de pagamento em um botão

Para enviar um botão de pagamento a um cliente:

1. Crie um botão com o **Pagamento** tipo
2. Selecione **PayTabs** como provedor de pagamento
3. Especifique:
   * descrição do pagamento;
   * valor do pagamento;
   * moeda.

<div data-with-frame="true"><img src="/files/1c927020c46d1772a6dc4d9174fb302ca7d36b50" alt="" width="554"></div>

***

## Tratamento do status do pagamento

Depois que o cliente abrir o link de pagamento e concluir o pagamento, um evento de callback será enviado para a conversa.

### Pagamento bem-sucedido

<div data-with-frame="true"><figure><img src="/files/4e80d23a361816f4d117e2ea6039334bd59d3936" alt="" width="357"><figcaption></figcaption></figure></div>

Exemplo:

```
SDJ91MTKTT_success 100
```

Onde:

* **SDJ91MTKTT** — os primeiros 10 caracteres do **Chave do servidor**
* **100** — o valor do pagamento

Para criar uma ação para um pagamento bem-sucedido, vá para **Builder** e crie um bloco com um gatilho (isso pode ser um bloco **Início** ou um bloco **Gatilho** ).

Depois, no campo **Gatilho** campo, insira:

* o valor completo do callback (se você quiser acionar a ação apenas para um valor de pagamento específico), ou
* apenas o valor do callback antes do valor do pagamento (se você quiser acionar a ação para todos os pagamentos bem-sucedidos).

<div data-with-frame="true"><figure><img src="/files/ef1a87db582ab8f9d4ed2fd1430f43e798595afe" alt=""><figcaption><p>O bloco "Início"</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/b107318875813fd74514fb5e7eaabaca81ef083c" alt=""><figcaption><p>O bloco "Gatilho"</p></figcaption></figure></div>

### Pagamento com falha

Exemplo:

```
SDJ91MTKTT_fail 100
```

O tratamento de pagamento com falha é configurado da mesma forma que o tratamento de pagamento bem-sucedido.

Crie um bloco com um gatilho e insira o valor do callback no **Gatilho** campo. Isso permite que você defina ações que serão executadas quando um pagamento falhar.

### Variáveis salvas após um pagamento bem-sucedido

Após um pagamento bem-sucedido, as seguintes variáveis são salvas automaticamente para o cliente:

**paytabs\_callback\_data**\
Contém a carga completa do webhook recebida do sistema de pagamento.

**paytabs\_payment\_completed**

Valor:

```
Verdadeiro
```

Indica que o pagamento foi concluído com sucesso.


---

# 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/integrations/payment/paytabs.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.