# Paypal
* [Cómo configurar Paypal ](#kak-nastroit-paypal)enlace Cómo configurar Paypal
* [Cómo crear un enlace de pago ](#sozdanie-ssylki-na-oplatu) enlace Cómo crear un enlace de pago
* [Cómo crear un pago recurrente](#kak-sozdat-rekkurentnyi-platezh) enlace Cómo crear un pago recurrente
* [Cómo procesar el resultado](#obrabotka-rezultata) enlace Cómo procesar el resultado
## Cómo configurar Paypal
Para trabajar con Paypal, necesitas obtener dos claves: **client\_id** y **secreto**
Ve a la página
Y elige de la lista o crea una nueva aplicación:
En la parte superior, cambia al modo Live y selecciona la aplicación deseada. Se abre la página de configuración, donde se encuentran los datos que necesitamos:
Copia los datos y pégalos en los campos correspondientes en la configuración de Mavibot: ve a la sección "Acquiring" y encuentra el servicio Paypal:
A continuación, haz clic en "Connect" y rellena los campos con la clave secreta y el Client ID recibidos anteriormente:
A continuación, haz clic en "Save settings". Con esto se completa la conexión.
## Cómo crear un enlace de pago
### Usando la variable payment\_sum
Para generar un enlace de pago, debes establecer el valor de la **payment\_sum** variable y justo después la **paypal\_pay\_url** variable aparecerá.
| Parámetros de la función | Descripción del parámetro | Nota |
| ------------------------ | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **payment\_title** |
(variable opcional) este es el nombre del producto.
| Si no se especifica, se rellena con el texto: **“Invoice payment order\_id"** (order\_id es el identificador del pedido en mavibot) |
| **payment\_description** | descripción del producto, campo opcional | |
| **company\_name** | el nombre de tu empresa se muestra en la parte superior de la página de pago (el ejemplo está abajo, company) | |
Además, antes de especificar payment\_sum, puedes indicar en qué idioma estará la página de pago.
Para ello, establece la variable locale. El idioma predeterminado es **Ruso (ru-RU).** Opciones posibles: da-DK, he-IL, id-ID, ja-JP, no-NO, pt-BR, ru-RU, sv-SE, th-TH, zh-CN, zh-HK, zh-TW, etc. (el conjunto de idiomas disponibles varía, toma como referencia la fuente original) ссылка [fuente original](https://developer.paypal.com/api/rest/reference/locale-codes/))
También puedes especificar la moneda en la que se aceptará el pago. Para ello, especifica la **currency** variable, la **rublos (RUB)** se establece por defecto; para dólares, establece su valor en USD (currency = USD). Las opciones de moneda posibles se pueden encontrar en el enlace. ссылка [enlace](https://developer.paypal.com/docs/api/reference/currency-codes/).
Y el tercer parámetro adicional es **company\_name** - el nombre de tu empresa, que se muestra en la parte superior de la página de pago (el ejemplo está abajo, company)
El **paypal\_pay\_url** la variable puede mostrarse con un enlace o colocarse en un botón con el texto "Pay".
El enlace se ve así: [https://www.paypal.com/checkoutnow?token=07N53571YM296381N](https://www.sandbox.paypal.com/checkoutnow?token=07N53571YM296381N)
Un ejemplo de la implementación.
Configuración del importe del pago y del nombre de la empresa
{% hint style="info" %}
**Tenga en cuenta:** el **payment\_sum** la variable se asigna en último lugar, después de las variables opcionales **payment\_title, company\_name,** etc.
{% endhint %}
A continuación, especifica la variable #**{paypal\_pay\_url}** en el segundo bloque "Status":
1. La variable puede especificarse en el campo message:
2. La variable puede especificarse en el campo url en la configuración del adjunto:
3. La variable puede especificarse en el campo url en la configuración del botón:
Al abrir el enlace de pago
### Usando la función de calculadora paypal\_payment\_url
Crea un bloque del constructor de embudos y usa la **paypal\_payment\_url** función en la calculadora, pasándole los parámetros necesarios:
el encabezado del pago (hasta 127 caracteres). (Si se omite, se rellena con el texto: “Invoice payment payment_id”, donde payment_id es el ID del pedido en Mavibot)
payment_description
breve descripción del pago (hasta 127 caracteres)
company_name
parámetro opcional, nombre de la organización/empresa, etc.
locale
El idioma de la página de pago se especifica como en-US, fr-XC, etc. Por defecto, es ‘ru-Ru’. La lista completa está disponible en el enlace https://developer.paypal.com/api/rest/reference/locale-codes/
Cuando se cumpla la condición del bloque, el cliente recibirá un enlace de pago, y la **paypal\_payment\_completed** variable del cliente se creará con el valor **False.**
`url = paypal_payment_url(2500,`` ``'RUB'``, 'Invoice payment payment_id','payment description', 'organization name', 'ru-Ru')`
## Cómo crear un pago recurrente
Para crear y recibir un enlace para pagar con pagos recurrentes, debes crear un **plan de suscripción** en tu cuenta personal.
Seleccionando una oferta ya creada:
Alternativamente, escribe el nombre de la oferta en la barra de búsqueda y haz clic en "Create".
Creación de una oferta de suscripción en paypal
Selecciona el tipo de cargo automático Fixed:
Crear suscripción
Elección de la moneda de la suscripción y de las condiciones del cargo:
{% hint style="danger" %} **¡Atención!!**
En Mavibot, la moneda predeterminada es el euro; si el cargo es en dólares o en otra moneda, al crear una suscripción especifica la moneda que necesites y en Mavibot la misma moneda de la suscripción de Paypal.
{% endhint %}
A continuación, activa la suscripción:
Después de crearla, estará disponible su ID, que utilizaremos en el futuro para crear una suscripción y recibir un enlace de pago.
El enlace de pago es generado y devuelto por la función:\
**paypal\_subscription\_url(plan\_id, shipping\_currency, shipping\_payment\_sum, start\_time)**
| Parámetros de la función | Descripción del parámetro |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **!** **plan\_id** | ID del plan de suscripción |
| **!** **shipping\_currency** | si el pago del plan especificado es en dólares, no tienes que transferir nada; de lo contrario, transferimos el código de moneda que especificaste en el plan. Aquí se transmite la moneda en la que se paga el envío (incluso para coste cero). Por defecto, USD |
| **shipping\_payment\_sum** | Este es un parámetro opcional que especifica el coste del envío. Por defecto, el valor se establece en cero. |
| **start\_time** |
parámetro opcional, fecha y hora de inicio de la suscripción. Si no transfieres nada, la fecha de inicio de la suscripción = la fecha del pago. Formatos: %d.%m.%Y o %d.%m.%Y %H:%M.
|
Al crear el enlace, la **paypal\_subscription\_id** variable también aparecerá, y contendrá el ID de la suscripción.
Durante el pago, recibirás un callback, que es similar al pago de un pago normal.
**paypal\_subscription\_data(paypal\_subscription\_id)** - obtención de información sobre la suscripción
| Parámetros de la función | Descripción de los parámetros |
| ---------------------------- | ----------------------------- |
| **paypal\_subscription\_id** | el ID de la suscripción. |
El **resultado** de ejecutar la función - es un array que contiene toda la información sobre la suscripción, incluyendo el número de pagos, el número de intentos fallidos de cobro, el estado y más.
### Cómo cancelar la suscripción
La función paypal\_remove\_subscription(paypal\_subscription\_id) ayudará a los clientes a cancelar sus suscripciones a tus servicios.
Parámetros:
| Parámetros de la función | Descripción |
| ------------------------ | -------------------------------------------------------------------------------- |
| paypal\_subscription\_id | el ID de la suscripción que se guarda en la variable del cliente al suscribirse. |
## Cómo procesar el resultado
{% hint style="info" %}
Después de un pago exitoso, se enviarán callbacks al bot, que te indicarán que el pago fue exitoso.
{% endhint %}
{% hint style="success" %}
En el sistema, ves los callbacks como mensajes del usuario, pero el propio usuario NO LOS VE: solo se muestran al operador.
{% endhint %}
{% hint style="danger" %}
Para procesar el callback en el bloque y enviar mensajes al usuario sobre el estado del pago, utiliza el tipo de comparación "Exact match".
{% endhint %}
{% hint style="warning" %}
Los callbacks pueden retrasarse, así que después de mostrar el enlace de pago al usuario, se recomienda enviar un mensaje como: “Después de realizar el pago, espera un mensaje de confirmación que indique que el pago fue exitoso.”
{% endhint %}
### Para pago directo
El callback de pago exitoso consiste en los primeros 10 caracteres del secreto y la firma con el estado. Por ejemplo: EHsWHYOoWV\_success
Ejemplo 1: reacción a un pago exitoso usando el bloque "Start condition":
Ejemplo 2: reacción a un pago exitoso usando el bloque "Start condition":
{% hint style="info" %}
Si no quieres sacar al usuario del flujo principal del chatbot, utiliza el bloque “No-state with condition” — los usuarios no pueden ser redirigidos directamente a este bloque, así que después de un pago exitoso seguirán en el embudo principal, al mismo tiempo que recibirán una notificación sobre el pago exitoso.
Pero si sí quieres continuar el embudo basándote en el evento de pago exitoso, usa el bloque “Start condition”. En este caso, después de completar el bloque de pago, el usuario será redirigido al bloque “Start condition”, desde el cual podrás seguir construyendo tu embudo.
{% endhint %}
{% hint style="info" %}
Más información sobre los bloques condicionales se proporciona en el artículo del mismo nombre. [блоках с условием рассказали](broken://pages/9c7b0563335b0dd52b155c8996e05cb9a6b2c0c9) ссылка
{% endhint %}
Tras un pago exitoso, la variable paypal\_payment\_completed se establece en True.
Después de completar el pago, se añade al cliente la variable paypal\_callback\_data, que contiene datos actualizados del sistema de pago sobre el estado de la transacción. Puedes extraer los datos necesarios del diccionario recibido usando el método get.
{% hint style="danger" %}
Para realizar un pago repetido, debes restablecer la variable payment\_sum, la variable con el enlace generado previamente y, a continuación, reasignar la variable payment\_sum o llamar a la función para obtener un nuevo enlace.
{% endhint %}
### Para pagos de suscripción
{% hint style="danger" %}
La función de configuración de callbacks para operaciones relacionadas con suscripciones se añadió el 09/01/2024. Para que los callbacks de esta categoría funcionen correctamente, debes desactivar y volver a conectar la integración del sistema de pago Paypal en tu proyecto.
{% endhint %}
Al realizar un pago de suscripción, el bot recibirá uno de los siguientes mensajes:
* sobre la activación de la suscripción. Por ejemplo, subscription\_I-PTV5H4MRC1H3\_activated;
* Notificación de un pago recurrente de suscripción exitoso. Por ejemplo, subscription\_I-PTV5H4MRC1H3\_paid;
* o sobre un error en el pago de la suscripción. Por ejemplo, subscription\_I-PTV5H4MRC1H3\_not\_paid;
En los ejemplos anteriores “I-PTV5H4MRC1H3” es el ID de la suscripción del cliente, al que se puede acceder usando la variable paypal\_subscription\_id.
El callback añadirá la variable paypal\_subscription\_callback\_data al cliente, que contiene datos actuales del sistema de pago sobre el estado de la transacción. Puedes extraer los datos necesarios del diccionario recibido usando el método get.
Ejemplo 1: reacción a la activación de la suscripción usando el bloque "Start condition":
Ejemplo 1: Reacción a la activación de la suscripción usando el bloque "Not state with condition":"
---
# 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/pago/paypal.md?ask=
```
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.