# Paytabs

## Conectando PayTabs a Mavibot

Para conectar PayTabs con Mavibot, debes configurar varios ajustes en tu cuenta de PayTabs.

### 1. Crear una clave API

En tu panel de control de PayTabs, ve a:

**Desarrolladores → Claves API**

Crea una nueva clave API.

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

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

Después de crear la clave API, guarda los siguientes datos:

* **Clave del servidor** — requerida para configurar la integración.
* **ID de perfil** — también requerido para la configuración de la conexión.

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

### 2. Configurar las notificaciones de pago

Ve a:

**Desarrolladores → Configuración**

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

Activa las notificaciones de pago (**callbacks**).

Haz clic en **"+"** y añade la siguiente URL de callback:

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

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

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

Esta URL se usa para enviar actualizaciones del estado del pago a Mavibot.

### 3. Configurar PayTabs en Mavibot

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

En la configuración de Mavibot:

1. Ve a la **Adquirencia** sección
2. Selecciona **PayTabs** como proveedor de pagos
3. Introduce los siguientes datos:
   * **ID de perfil**
   * **Clave del servidor**
4. Selecciona tu **región de la cuenta de PayTabs**

{% hint style="info" %}
**¡Ten en cuenta!**\
La región seleccionada debe coincidir con la región en la que está registrada tu cuenta de PayTabs.
{% endhint %}

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

Una vez guardados los ajustes, se completará la configuración de la integración.

### Generar un enlace de pago

Para generar un enlace de pago, usa la siguiente función:

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

#### Parámetros de la función

| Parámetro                                        | Descripción                                                     |
| ------------------------------------------------ | --------------------------------------------------------------- |
| <mark style="color:$danger;">**!**</mark> amount | Importe del pago. Parámetro obligatorio                         |
| description                                      | Descripción del pago. Parámetro opcional                        |
| currency                                         | Moneda del pago. Parámetro opcional                             |
| customer\_email                                  | Dirección de correo electrónico del cliente. Parámetro opcional |
| customer\_phone                                  | Número de teléfono del cliente. Parámetro opcional              |
| full\_name                                       | Nombre completo del cliente. Parámetro opcional                 |
| language                                         | Idioma de la página de pago. Parámetro opcional                 |

#### Monedas disponibles

Se admiten los siguientes códigos de moneda:

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

#### Idiomas disponibles

```
en — Englishar — Arabicfr — French
```

La función devuelve una URL de pago.

Si no se proporciona el **currency** parámetro, la moneda se seleccionará automáticamente según la región configurada.

### Usar el enlace de pago en un botón

Para enviar un botón de pago a un cliente:

1. Crea un botón con el **Pago** tipo
2. Selecciona **PayTabs** como proveedor de pagos
3. Especifica:
   * descripción del pago;
   * importe del pago;
   * moneda.

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

***

## Gestión del estado del pago

Después de que el cliente abra el enlace de pago y complete el pago, se enviará un evento de callback a la conversación.

### Pago exitoso

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

Ejemplo:

```
SDJ91MTKTT_success 100
```

Donde:

* **SDJ91MTKTT** — los primeros 10 caracteres de **Clave del servidor**
* **100** — el importe del pago

Para crear una acción para un pago exitoso, ve a **Builder** y crea un bloque con un disparador (esto puede ser un bloque **Start** o un bloque **Trigger** ).

Luego, en el campo **Trigger** introduce:

* el valor completo del callback (si quieres activar la acción solo para un importe de pago específico), o
* solo el valor del callback antes del importe del pago (si quieres activar la acción para todos los pagos exitosos).

<div data-with-frame="true"><figure><img src="/files/2275e1167d16e4d2285ae1205d46ba10488158ff" alt=""><figcaption><p>El bloque "Start"</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/215c076ad3531ac2b10c75fe295793be565382e8" alt=""><figcaption><p>El bloque "Trigger"</p></figcaption></figure></div>

### Pago fallido

Ejemplo:

```
SDJ91MTKTT_fail 100
```

La gestión de pagos fallidos se configura de la misma manera que la de pagos exitosos.

Crea un bloque con un disparador e introduce el valor del callback en el campo **Trigger** . Esto te permite definir acciones que se ejecutarán cuando un pago falle.

### Variables guardadas después de un pago exitoso

Después de un pago exitoso, las siguientes variables se guardan automáticamente para el cliente:

**paytabs\_callback\_data**\
Contiene la carga útil completa del webhook recibida del sistema de pago.

**paytabs\_payment\_completed**

Valor:

```
True
```

Indica que el pago se ha completado con éxito.


---

# 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/es/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.