# Stripe ## Cómo conectar Para conectar el sistema de pago Stripe, necesitará una clave API secreta y una clave de webhook. Puede copiar la clave API secreta yendo a la sección Developers -> API key y copiando la Secret key. Paso 1. Vaya a la sección Developers -> API key:

Paso 2. Encuentre y copie la Secret key:

A continuación, debe establecer la URL para los callbacks. Esto es necesario para que el bot reciba notificaciones de pago. Vaya a la sección Webhooks y añada la dirección para los webhooks.

Se abre el formulario:

Paso 1. Haga clic en "+add destination". Paso 2. Seleccione los eventos:

Paso 3. Seleccione el tipo de "Webhook endpoint":

Paso 4. Nos familiarizamos con el tipo de solicitud y hacemos clic en "Continue":

Paso 5. Escribimos el nombre y especificamos la URL del endpoint:

Especifique la URL - Paso 6. Se crearán dos endpoints, puede ver la configuración antes de añadirlos:

Paso 7. A continuación, haga clic en el botón "Add destinations". Entonces los webhooks se guardarán. Paso 8. Haga clic en el botón "Done".

Lo guardamos y llegamos a la página con el webhook instalado:

Paso 9. A continuación, haga clic en el webhook donde seleccionó todos los eventos:

Paso 10. Encontramos la clave Signig y la guardamos para nosotros (en el futuro la necesitaremos para conectarla a Salebot):

Después de recibir las claves, procedemos a conectar con Mavibot. En Mavibot, abra la sección "Acquiring" y seleccione Stripe.

En la página de conexión, debe introducir las claves recibidas:

Haga clic en "Save Settings". {% hint style="success" %} ¡Listo! ¡Con esto se completa la conexión del sistema de pago! {% endhint %} ## Cómo conectar un callback sobre el estado de la transacción Para obtener un callback adicional, necesitaremos conectar un webhook en **además del existente.** Especifique la URL - [https://chatter.salebot.pro/stripe\_callback/\/charge\_status](https://chatter.salebot.pro/stripe_callback//charge_status) y seleccione los eventos: * `charge.failed` * `charge.pending` * `charge.succeeded`

{% hint style="success" %} **Obtenga más información sobre cada tipo de webhook:** 1. **charge.succeeded** - contiene información sobre la finalización exitosa de la transacción (similar a un callback sobre un pago exitoso) 2. **charge.pending** - "la transacción está en curso", puede tardar hasta 7 días en completarse.\ El webhook tendrá este aspecto: {primeros 10 caracteres}{tipo de webhook}\ *Por ejemplo*: *sk\_test\_45LDPJLKT95d\_charge.pending* 3. **charge.failed** *-* "la transacción falló."\ El webhook tendrá este aspecto: {primeros 10 caracteres}{tipo de webhook}\ Por ejemplo: *sk\_test\_45LDPJLKT95d\_charge.failed* {% endhint %} Añadimos el webhook recibido después de guardarlo en Mavibot en el campo - Webhook key2:

**stripe\_invoice\_id** - ID de la transacción para la cual no se recibió inmediatamente después del pago el callback de pago exitoso. ## Cómo conectar impuestos Para usar impuestos en los pagos, primero debe crearlos en la cuenta personal de Stripe. Para ello, escriba tax rates en la barra de búsqueda:

Y haga clic en "+ Add tax rates":

A continuación, especifique la tasa de impuesto aplicable:

En el menú que se abre, seleccione el tipo de impuesto, la región a la que se aplica, la tasa impositiva y la opción que indica si este impuesto debe incluirse en el importe del pago 'Inclusive' o añadirse por encima del importe - exclusive:

Después de crear la tasa impositiva, copie su ID en la **stripe\_tax\_id** variable antes de establecer el importe del pago.

Para evitar errores, ponga una cadena vacía ("") en la variable stripe\_tax\_id después de recibir el enlace, para poder aplicar el impuesto solo cuando sea necesario. Si todo se hace correctamente, entonces, en el caso de la tasa impositiva con el parámetro exclusive, verá lo siguiente

Ejemplo de un pago con una tasa impositiva exclusive

## **Cómo obtener un enlace de pago** Para generar un enlace de pago, debes establecer el valor de la **payment\_sum** variable (por ejemplo, 150 o 100.55 (separado por un punto!)), y después aparecerá la variable stripe\_pay\_url. Esta variable puede mostrarse con un enlace o colocarse en un botón con el texto "Pay". El enlace se ve así: `https://checkout.stripe.com/pay/cs_test_a17mskKFFRwEuo3WgBSAUjfk7xaZZIrct9B3Ds2AdODVq1I8aRiqYEBdrU#fidkdWxOYHwnPyd1blpxYHZxWjA0TGFsVzFPVmpmMzJAbVYzUkp1Y0lLYDVgfzR2Q0NxcWZBNUNnTnRSVVRJSGFobEB1UExSczRMMTc8PWRLMGBddl8xalxyPDRoUGhnZm9xXXZANDZyaF0wNTVBVExsPHZyfycpJ2N3amhWYHdzYHcnP3F3cGApJ2lkfGpwcVF8dWAnPyd2bGtiaWBabHFgaCcpJ2BrZGdpYFVpZGZgbWppYWB3dic%2FcXdwYHgl` {% hint style="warning" %} De forma predeterminada, se establece USD (dólar); si necesita otra moneda, debe establecer el valor de la **currency** variable. {% endhint %} Además, antes de establecer el valor de la **payment\_sum** variable, puede establecer las siguientes variables opcionales para configurar el pago.

Parámetros de la función	Descripción de los parámetros
currency	es la moneda del pedido. Valores aceptables -https://stripe.com/docs/currencies
payment_description	descripción del pedido
stripe_tax_id	Este es el ID de la tasa impositiva, configurado en la cuenta personal de Stripe. Cómo configurarlo se describe en la sección "Cómo configurar impuestos" ссылка "Cómo conectar impuestos"
stripe_invoice_enable	Este parámetro indica la necesidad de guardar facturas (invoices, receipts). Introduzca cualquier valor: todos los documentos necesarios estarán entonces disponibles en su cuenta personal de Stripe.
stripe_locale	establece el idioma del enlace de pago: en, ru, de. Todos los idiomas disponibles están aquí: https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-locale Si el stripe_local si no se proporciona un valor, se usará por defecto el idioma del navegador del cliente.
stripe_payment_method_type	es el método de pago; el pago predeterminado es con tarjeta. Puede reemplazarlo por otros métodos de pago disponibles en Stripe. Los métodos disponibles se enumeran a continuación Por ejemplo, `stripe_payment_method_type = "customer_balance"`
stripe_additional_payment_method_type	es para añadir un método de pago adicional. Los métodos disponibles se enumeran a continuación, por ejemplo, `stripe_additional_payment_method_type = "sepa_debit"`
coupon_id	ID del cupón de descuento
stripe_expired	es la duración del enlace de pago. Se especifica en segundos. El tiempo mínimo es 30 minutos, el máximo es 24 horas. El valor predeterminado es 24 horas
stripe_automatic_tax	activación del cálculo y cobro automático de impuestos durante el pago. Para activarlo, pase "1". La información detallada sobre esta configuración se puede encontrar en la documentación de Stripe. ссылка en la documentación de Stripe

{% hint style="warning" %} ¡Atención! Si usa ambas ***stripe\_payment\_method\_type** y **stripe\_additional\_payment\_method\_type*** variavles***, entonces los valores en ellas ¡DEBEN ser DIFERENTES!*** {% endhint %}

Lista de valores para stripe_payment_method_type y stripe_additional_payment_method_type

card\ acss\_debit\ affirm \ afterpay\_clearpay \ alipay\ au\_becs\_debit \ bacs\_debit \ bancontact \ blik \ boleto \ cashapp \ customer\_balance \ eps \ fpx \ giropay \ grabpay \ ideal \ klarna \ konbini \ link \ oxxo \ p24 \ paynow \ paypal \ pix \ promptpay \ sepa\_debit \ sofort \ us\_bank\_account \ wechat\_pay zip

Puede obtener más información sobre cada uno de los métodos y para qué países están disponibles en la documentación de Stripe: [ver en el sitio ](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) ### **Ejemplo de creación del enlace de pago** Creemos un enlace de pago por un importe de 1000 rublos (por defecto, dólar)

{% hint style="warning" %} **Tenga en cuenta:** \ \- Primero indique parámetros opcionales **first\_name, payment\_description** y así sucesivamente.\ \- Y al final asignamos el valor a la variable **payment\_sum** Las variables también se pueden establecer antes en la cadena, y no en un solo bloque; esto es un ejemplo. {% endhint %} Luego, en el lugar necesario, mostramos la variable **stripe\_pay\_url**, que contiene el enlace en el bloque o en el botón: Ejemplo 1. Mostramos el enlace de pago directamente en el mensaje:

Pruebas en el bot:

Ejemplo 2. Añadimos el enlace de pago a un botón:

Ejemplo 3. Añadimos el enlace como adjunto al mensaje:

Pruebas en el bot:

{% hint style="success" %} Los tres варианты son válidos para enviar el enlace de pago en el bot. {% endhint %} Al hacer clic en el botón o al seguir el enlace, su pagador será redirigido a la página de pago:

En el ejemplo se ve que se aplicaron los parámetros que indicamos en la calculadora en la configuración del bloque: descripción del pedido, moneda e importe. Si pasa el parámetro de tasa impositiva (**stripe\_tax\_id)** en el bloque:

Entonces también se mostrará la tasa impositiva en el formulario de pago:

Ejemplo de código para copiar

`payment_description = 'Pago de prueba en Stripe'` \ `currency = 'RUB'` \ `stripe_tax_id = 'copie aquí su tax ID'` \ `payment_sum = 1000` Dónde encontrar el tax ID:

## **Cómo configurar pagos recurrentes** Para los pagos recurrentes (suscripciones), antes de declarar la variable **payment\_sum** declare la variable **stripe\_subscription** y asígnele el nombre de la suscripción. También puede añadir las siguientes variables: \ **interval** – duración del intervalo de suscripción; a esta variable debe pasar el valor **‘day’** - para días, **‘week’** - semanas, **‘month’** - meses, **‘year’** - años. \ Si la variable no se declara, entonces ***por defecto*** se pasará el parámetro **‘month’.** {% hint style="warning" %} **¡Importante!** La duración de un ciclo de suscripción no puede ser superior a 1 año (para el parámetro ‘year’), más de 12 meses (para el parámetro ‘month’), ni más de 52 semanas (para el parámetro ‘week’). {% endhint %}

**interval\_count** – número de intervalos especificados: cuántos días, semanas o meses habrá en la suscripción por la cantidad indicada. ***Por defecto*** se pasará un parámetro igual a uno (**1**); **stripe\_payment\_method\_type** - método de pago; por defecto está seleccionado el pago con tarjeta (card). Puede reemplazarse por otros métodos de pago disponibles en Stripe. A continuación se indican los métodos disponibles. Por ejemplo, `stripe_payment_method_type = 'customer_balance'` **stripe\_additional\_payment\_method\_type** - añadir un método de pago adicional. A continuación se indican los métodos disponibles Por ejemplo, `stripe_additional_payment_method_type = 'sepa_debit'` {% hint style="warning" %} ¡Importante! Si usa ambas variables ***stripe\_payment\_method\_type** y **stripe\_additional\_payment\_method\_type, entonces los valores en ellas ¡DEBEN ser DIFERENTES!*** {% endhint %}

Lista de valores para stripe_payment_method_type y stripe_additional_payment_method_type:

{% hint style="info" %} Para obtener más información sobre cada uno de los métodos y para qué países están disponibles, consulte la documentación de Stripe: ver el sitio web ссылка [ver en el sitio ](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) {% endhint %} {% hint style="warning" %} **¡Atención!** La duración de la suscripción no puede exceder 1 año (para el parámetro ‘year’), más de 12 meses (para el parámetro ‘month’), ni más de 52 semanas (para el parámetro ‘week’). {% endhint %} En este ejemplo, se creará una suscripción llamada 'My\_subscription' con un precio de 90 USD durante 3 meses y se realizará un pago recurrente por el mismo importe después de 1 mes:

Un ejemplo para copiar: `stripe_subscription = 'My_subscription'` \ `interval = 'month'` \ `interval_count = 3` \ `payment_sum = 90` Después del pago, el cliente tendrá **stripe\_subscription\_id** variables en las variables del trato, que serán necesarias para configurar la cancelación de la suscripción, y **stripe\_customer\_id**, que más adelante se puede usar para comprobar el estado de la suscripción. {% hint style="warning" %} ¡La notificación (callback) se recibe solo en el primer pago recurrente! NO HABRÁ callback para las llamadas repetidas. El control pasa por la función y el stripe\_customer\_id. [a través de la función](#proverka-statusa-podpiski) ссылка {% endhint %}

### Volver a la configuración de pagos regulares Para volver a los pagos regulares, asigne a la variable de suscripción una cadena vacía **stripe\_subscription = "**. En este caso, las variables interval y interval\_count no afectarán a la creación del enlace.

### **Cancelación de la configuración de suscripción** Para cancelar una suscripción en la calculadora, use el **stripe\_remove\_subscription(stripe\_subscription\_id)** método, donde **stripe\_subscription\_id** es el identificador que se guardó en la información del trato después del pago. Esto le permitirá mantener activa su suscripción de pago hasta el final del período pagado actual, pero no se realizarán más cargos, y la suscripción se cancelará después de la fecha de vencimiento:

answer = stripe\_remove\_subscription('#{stripe\_subscription\_id}') stripe\_remove\_subscription - Si tiene éxito, recibirá una respuesta con información sobre la fecha en la que la suscripción cancelada sigue siendo válida. En este ejemplo, el resultado de la ejecución de la función se colocará en la variable answer y se podrá comprobar el resultado de la ejecución. ### Comprobación del estado de la suscripción **stripe\_check\_subscription(subscription\_id, customer\_id)**, donde **stripe\_subscription\_id** - ID de la suscripción \ **stripe\_customer\_id** - ID del cliente en Stripe (parámetro opcional)

## Cómo crear un cupón y obtener un ID de descuento Para obtener el ID del descuento, cree un cupón en su cuenta personal en la sección ”coupons”. ссылка ”[coupons](https://dashboard.stripe.com/coupons)”.

Después de hacer clic en el botón “New”, se abre una página donde debe especificar: 1. Name — nombre del descuento; 2. ID — identificador que se genera automáticamente. 3. Type — tipo de descuento: porcentaje o cantidad fija 4. Duration — la duración del descuento (único o recurrente, por ejemplo, para suscripciones) y otros parámetros.

El cupón de descuento aparecerá en el “Product catalog“ en la sección “Coupons”, y podrá ver el ID del descuento entrando en el menú del cupón:

Haga clic en el cupón para copiar el ID del cupón:

### Cómo añadir un descuento al pedido 1. Al generar un enlace de pago (tanto para suscripciones como para pagos únicos). En la calculadora del bloque, antes de declarar la **payment\_sum** variable, establezca la **coupon\_id** variable asignándole el ID del descuento de la cuenta personal de Stripe.

2. Para añadir a una suscripción existente usando el **stripe\_add\_subscription\_discount** función. Establezca las condiciones para activar el bloque y llame a la función especificada en la calculadora, proporcionándole los parámetros stripe\_subscription\_id (id de suscripción) y coupon\_id (id del cupón de descuento). El descuento se aplicará a los pagos posteriores de la suscripción.

Ejemplo de código para copiar

`stripe_subscription = 'Suscripción premium'` \ `interval = 'month'` \ `payment_description = 'Pago de prueba en Stripe'` \ `currency = 'USD'` \ `coupon_id = 'ID de su cupón'` \ `stripe_add_subscription_discount(stripe_subscription_id, coupon_id)` \ `stripe_tax_id = 'ID del impuesto'` \ `payment_sum = 90`

Si se añade correctamente, la función devuelve un mensaje que indica el ID de la suscripción, el tipo, el importe o el porcentaje del descuento y también su fecha de vencimiento.

{% hint style="info" %} Para obtener más información sobre la creación de una suscripción, consulte la sección "Cómo configurar pagos recurrentes" ссылка "[Cómo configurar pagos recurrentes](#kak-nastroit-rekurrentnye-platezhi)" {% endhint %} ### Cómo eliminar/cambiar el descuento de la suscripción El descuento adjunto a la suscripción puede eliminarse o sustituirse por otro descuento. Si desea terminar el descuento, establezca una condición para activar el bloque y llame a la **stripe\_remove\_subscription\_discount** función en la calculadora, proporcionándole el **stripe\_subscrition\_id** parámetro (id de suscripción).

Al completarse correctamente la operación, la función devuelve un mensaje que contiene el ID de la suscripción y la fecha de cancelación del descuento. La sustitución del descuento, así como la adición de uno nuevo, se realiza mediante **stripe\_add\_subscription\_discount** función. No olvide pasarle los **stripe\_subscription\_id** y **coupon\_id** parámetros.\ Una solicitud correcta actualizará el cupón adjunto a la suscripción y devolverá un mensaje con la información actual. {% hint style="info" %} Puede leer cómo obtener un ID de descuento en la sección "Cómo crear un cupón y obtener un ID de descuento". ссылка "[Cómo crear un cupón y obtener ID de descuento](#kak-sozdat-kupon-i-poluchit-id-skidki)". {% endhint %} ## Cómo procesar el resultado Después de un pago exitoso, se enviarán callbacks al bot, lo que le hará saber que el pago fue exitoso. Verá estos callbacks en el sistema como mensajes del usuario, de modo que el usuario no pueda enviarlos; consisten en los primeros 20 caracteres de la clave secreta y el sufijo de éxito, por ejemplo: **sk\_live\_d35gky6d8ers\_success**

Estos callbacks NO SON VISIBLES para el usuario, solo se muestran al operador. El tipo de comparación debe ser "**Coincidencia exacta"** Además, después de un pago exitoso, **stripe\_payment\_completed** variable se establece en **True.** Por ejemplo, puedes procesar un pago exitoso en un bloque condicional y mostrar el mensaje correspondiente al usuario:

Después de completar el pago, la **stripe\_callback\_data** variable se añadirá al cliente, conteniendo los datos de la respuesta del sistema de pago sobre la transacción completada. Puede extraer los datos necesarios del diccionario resultante usando la **get** . {% hint style="warning" %} Para hacer un pago repetido, debe restablecer payment\_sum, el enlace generado previamente y luego reasignar la variable payment\_sum para obtener un nuevo enlace. Puede especificar el valor anterior. {% endhint %} ## **Cómo probar los pagos** Para probar la integración, puede usar la clave secreta del entorno de pruebas. Para ello, cambie al modo de prueba en la cuenta personal de Stripe usando el interruptor del menú derecho ![](https://lh5.googleusercontent.com/r-tuJboMES8alkTUpKwA4HKrmL_epNtSXdENrv12EyR9dGCtvRLBK6qw4UGcr59GA3unxc1cV1otCu80nqHEw9VhbEK05ovPQ1Ad8chBv50LAWPO16nEPC2hFhCAsCe3khtBJrob=s0) A continuación, realice la configuración descrita al principio de esta guía. Introduzca la clave secreta de prueba y añada la dirección del webhook al entorno de prueba. El número de tarjeta de prueba 4242 4242 4242 4242\ cualquier fecha futura\ CVC - cualquier tres números Si algo no funciona, compare los datos con los datos del sitio web oficial. ссылка[ en el sitio web oficial.](https://stripe.com/docs/testing#regulatory-cards) --- # 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/stripe.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.