Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Prodamus (KZ)

Cómo conectar Prodamus

Para conectar Prodamus, necesitas la URL del formulario de pago y una clave secreta.

La URL del formulario de pago se proporciona después del registro; su ejemplo es: demo.payform.ru.

La clave secreta se puede obtener en el panel personal; allí también debes indicar la URL a la que se enviarán las notificaciones.

Clave secreta en la configuración del formulario de pago en el panel personal del sistema de pagos «Prodamus»

Instrucciones detalladas sobre cómo hacerlo

Dirección para las notificaciones: https://chatter.mavibot.ai/prodamus_callback/result

Esta dirección debe indicarse en dos lugares de la configuración.

En la página principal de configuración puedes elegir el modo de funcionamiento del formulario de pago: modo demo sin pagos o modo de aceptación de pagos.

La dirección para las notificaciones debe indicarse en dos lugares dentro de la configuración del sistema de pagos: «Configurar formulario» pestaña — para pagos únicos (normales) y «Suscripciones» pestaña — para pagos por suscripción.

Dirección para las notificaciones: https://chatter.mavibot.ai/prodamus_callback/result

Para configurar el trabajo con pagos por suscripción «Suscripciones» ve a la pestaña y especifica la dirección para las notificaciones:

https://chatter.mavibot.ai/prodamus_callback/result

¡Atención! Después de introducir la URL, asegúrate de «Guardar» botón.

Para conectar Prodamus «Adquirencia» debes ir a la sección.

Luego basta con introducir en el formulario los datos mencionados arriba:

¡Importante! Al indicar la URL del formulario de pago https:// no la incluyas.

Así, la conexión ha finalizado. Ahora veamos cómo usar esta funcionalidad.

Cómo crear un enlace de pago

Botón con la función «Pagar»

Se puede crear un enlace de pago en un botón con la función «Pagar».

En este artículo se explica cómo crear ese botón.

Ahora revisemos todos los parámetros posibles de este botón.

Parámetros obligatorios del botón «Pagar» para Prodamus

Para crear un enlace de pago, es necesario indicar los parámetros obligatorios en la configuración del botón: «Importe», «Nombre del producto», así como el parámetro «Contenido pagado» — si no tienes tu propia caja registradora en línea y quieres recibir un recibo de Prodamus.

Al pasar a la página de pedido, se mostrará previamente información sobre el producto y su precio, y el cliente solo tendrá que introducir sus datos de contacto.

Si en la configuración del botón se especifica el Email y/o el teléfono del usuario, en la página de pedido se mostrarán los datos de contacto del pagador y la información sobre el producto y su precio.

Ventana de configuración del botón

Campo «Texto» – este texto se mostrará en la notificación en el botón con enlace de pago.

Campo «Función» – para crear un botón que genere un enlace de pago, seleccionamos la función «Pagar».

Campo «Sistema de pago» – los sistemas de pago conectados al proyecto se mostrarán en la lista. Si no hay ningún sistema de pago conectado al proyecto, este tipo de botón no estará disponible.

Campo «Nombre del producto» (obligatorio) – es necesario indicar el nombre exacto del producto. Por ejemplo: no «Teléfono», sino «Smartphone Xiaomi, modelo …». Nota: no se pueden usar comillas dobles en el nombre del producto; elimínalas o sustitúyelas por comillas simples.

Campo «Importe» (obligatorio) – indicamos el precio del producto.

Menú «Información adicional» – al pulsar este botón se abrirán campos adicionales para crear el enlace:

  • Descripción del pedido

  • Descuento en rublos

  • Variable del Email del comprador

  • Variable del número de teléfono del comprador

  • Tiempo de validez del enlace

  • ID del producto para suscripción (para crear pago automático)

  • Contenido pagado

Casilla «Notificar al pulsar» – se puede marcar para controlar el acceso al enlace de pago. En ese caso, al pulsar el botón, llegará un mensaje al diálogo del cliente en SaleBot informando de que se ha accedido al enlace.

Con este mensaje se puede configurar la lógica posterior del bot. Muchos sistemas de pago admiten cajas registradoras en línea en la nube, que son necesarias según los requisitos de la Ley 54-FZ.

Lee las particularidades de la emisión de recibos en el sitio del sistema de pago seleccionado para no tener problemas con la inspección tributaria.

Así se ve la página de pago que se abre al seguir el enlace en el botón «Pagar»:

Página de pago: en el botón solo se completan los parámetros principales

Configuraciones adicionales para crear un enlace de pago

Campo «Descripción del pedido» – la información introducida en este campo se mostrará en la página de pago Datos adicionales campo.

Campo «Descuento» – aquí se puede indicar el importe del descuento en rublos o en rublos y kopeks. Para indicar los kopeks, usa el punto como separador: 50.99 En la página de pago Importe a pagar campo se mostrará teniendo en cuenta el descuento, y el precio principal del producto aparecerá tachado.

Campo «Variable del Email del comprador» (opcional, si se proporciona el número de teléfono) – aquí se indica el Email del usuario (cliente). También puedes usar una variable guardada con el Email, por ejemplo: #{email}

Campo «Variable del número de teléfono del comprador» (opcional, si se proporciona el Email) – aquí puedes usar la variable que contiene el número de teléfono del comprador, formato: 79000000000, por ejemplo: #{phone} Es obligatorio indicar Email y/o teléfono.

Campo «Tiempo de validez del enlace» – fecha dd.mm.aaaa hh:mm en formato (por ejemplo, 25.01.2021 11:00) o se puede establecer la fecha de caducidad del enlace mediante una variable. Por ejemplo: #{link_expired}

Campo «ID del producto para suscripción» – para crear un pago automático, proporciona el valor del ID del producto. Para crear una suscripción, debes crear un producto de suscripción. Instrucciones detalladas: Creación y configuración de suscripciones en Prodamus Si se proporciona el ID del producto para la suscripción, no se tiene en cuenta el importe del pago. La información del producto se toma de la ficha del producto en el panel de Prodamus. El número de teléfono indicado en el pago será necesario para gestionar la suscripción. Si se proporciona el ID del producto para la suscripción, al realizarse correctamente el pago, en el callback se devolverá el ID de este producto.

Campo «Contenido pagado» (condicionalmente obligatorio) – estos datos son necesarios para fiscalizar el pago a través de Prodamus si no tienes tu propia caja registradora en línea. En este campo se indican la descripción de la compra, el precio y el enlace al contenido. Por ejemplo: Curso ‘Trenzado de cabello’, precio 3000 rublos, enlace a la página del curso: https://nbu.su/krasota/master-po-pleteniyu-kos/?yclid=13602995275739430911

Botón con la función «Pagar»

Si indicas el tiempo de validez del enlace, ocurrirá lo siguiente: Si el usuario solicita el enlace de pago dentro de su período de validez (es decir, cuando el tiempo del enlace aún no ha expirado) y está en el diálogo, no será posible realizar el pago, y se le mostrará el siguiente mensaje:

La fecha de caducidad del enlace debe ser posterior a la fecha actual; de lo contrario, el cliente no podrá pagar con este enlace.

2. Cuando el usuario solicite el enlace, si actualmente no está activo En ese caso, el botón simplemente no se mostrará. En las variables del cliente "error_payment_button" aparecerá la variable, cuyo valor será el siguiente: "Error: la fecha de caducidad del enlace debe ser posterior a la fecha actual".

Para que el usuario pueda realizar el pago correctamente, se recomienda procesar adicionalmente esta situación.

Crea el siguiente bloque condicional: Si llega el siguiente mensaje: error_payment_button == "Error: la fecha de caducidad del enlace debe ser posterior a la fecha actual"

Entonces muestra el siguiente texto: "Lo sentimos, no pudiste pagar a tiempo; el enlace de pago ya no era válido".

Variables de cliente creadas automáticamente al usar un botón con la función «Pagar»

Cuando el usuario recibe un bloque con un botón «Pagar», se crean automáticamente variables para el cliente:

Variable de cliente de servicio __payments – esta variable almacena el importe y el identificador del enlace creado, y es necesaria para detectar el webhook que llega desde el sistema de pago.

Variable de cliente de servicio __payments¡No se puede desactivar ni modificar!

error_payment_button variable de cliente se crea automáticamente si aparece un error al generar el botón. En esta variable se guarda el texto del error o la respuesta de error del sistema de pago.

Los valores de las variables serán vigentes al pasar al siguiente bloque.

Cómo procesar el resultado

Pago exitoso Después de un pago exitoso, al bot CALLBACK AUTOMÁTICO llega, que consta de los primeros 10 caracteres de la clave secreta del sistema de pago, _success de la palabra y del importe del pago. Para usarlo en la configuración del esquema, basta con copiarlo tal cual.

Por ejemplo: ovg58keefc_success 44, donde:

  • ovg58keefc – los primeros 10 caracteres de la clave secreta del sistema de pago

  • _success – el resultado del procesamiento de la solicitud (pago exitoso)

  • 44 – el importe del pago

El usuario NO VE los callbacks (notificaciones). Solo «Clientes» pestaña y son visibles para el operador.

Ejemplo de uso: Paso 1. Añadimos botones con la función «Pagar» al bloque «Botón con pago». Paso 2. En el campo Condición de enlace especificamos el callback que lleva de este bloque al bloque «Pago exitoso». Del mismo modo, si en la condición del bloque «Condición inicial» se especifica el callback de pago exitoso, el funcionamiento será similar.

Importante: Selecciona «Coincidencia exacta» o «Por presencia de palabras clave».

❗️Si decides verificar el pago exactamente en la flecha indicada por la condición, piensa bien la lógica de tu esquema. Si el cliente sale del bloque por el que pasa el callback según la condición, no se producirá la transición al bloque. Este método de comprobación es mejor usarlo solo si el cliente no ha cambiado de posición en el embudo.

En los esquemas donde el cliente se mueve entre bloques, es más conveniente usar la opción de especificar el callback en el bloque «Condición inicial» .

Callback de pago exitoso en el campo de condición del bloque.

Pago exitoso para productos con suscripción automática

Después de un pago exitoso, al bot CALLBACK AUTOMÁTICO llega, que consta de los primeros 10 caracteres de la clave secreta del sistema de pago, _success de la palabra y del ID del producto de suscripción.

Por ejemplo: 214009eefc_success 618117, donde:

  • 009eefc – los primeros 10 caracteres de la clave secreta del sistema de pago

  • _success – el resultado del procesamiento de la solicitud (pago exitoso)

  • 618117 – ID del producto de suscripción

Ejemplo de callback de Prodamus para productos con suscripción automática

Pago con error En caso de que se produzca un error al realizar el pago, al bot CALLBACK AUTOMÁTICO llega, que consta de los primeros 10 caracteres de la clave secreta del sistema de pago, _fail de la palabra y del importe del pago.

Por ejemplo: ovg58keefc_fail 44, donde:

  • ovg58keefc – los primeros 10 caracteres de la clave secreta del sistema de pago

  • _fail – resultado del procesamiento de la solicitud (el pago no se realizó o hubo un error)

  • 44 – el importe del pago

Esto depende del sistema de pago. No todos los sistemas de pago envían un callback de error de pago.

Si el importe indicado en la configuración del botón difiere del importe pagado por el cliente, al bot CALLBACK AUTOMÁTICO llegará. Consta de los primeros 10 caracteres de la clave secreta del sistema de pago, _different_amounts de la palabra y del identificador único del pago.

Por ejemplo: ovg58keefc_different_amounts 123456, donde:

  • ovg58keefc – los primeros 10 caracteres de la clave secreta del sistema de pago

  • _different_amounts – resultado del procesamiento de la solicitud (el importe del pago difiere del importe del enlace)

  • 123456 – identificador único del pago

En la Calculadora get_prodamus_payment_url función

Para crear un enlace de pago en el bloque Calculadora get_prodamus_payment_url función puedes usar la. En el campo de la Calculadora asignamos a la variable el valor de esta función: get_prodamus_payment_url.

Tú eliges el nombre de la variable. En las capturas se muestran ejemplos de nombres de variables.

En esta variable se escribe el enlace de pago. La variable puede mostrarse en el mensaje como enlace o colocarse en un botón con el texto «Pagar».

Ejemplo de enlace de pago: https://payform.kz/7p3JR8/

Ejemplo 1:

Si en el bloque hay varias funciones de obtención de enlaces y se produce un error, el valor del error error_payment_func se escribirá en la variable.

El error se escribe en la Calculadora según la última función.

payment_sum creación del enlace mediante la variable y parámetros adicionales

Atención: payment_sum a la variable se le asigna el valor de la última variable, es decir, después de las variables no obligatorias: payment_description, product_name etc.

Para crear un enlace de pago En el campo de la Calculadora payment_sum basta con establecer el valor de la variable. Después de esto se generará automáticamente prodamus_pay_url variable.

Ejemplo de enlace de pago: https://payform.ru/7p3JR8/

Esta variable puede mostrarse en el mensaje como enlace o colocarse en un botón con el texto «Pagar».

payment_sum Antes de declarar la variable pueden especificarse estas variables opcionales:

Parámetros de la función
Descripción del parámetro

product_name

Nombre del producto (si no se indica, automáticamente se completará "Pago de la factura order_id'

payment_description

Descripción del producto (si no se indica, automáticamente 'Pago de la factura order_id' se completará) – en la captura de abajo se muestra dónde se indica.

discount_value

Importe del descuento (por ejemplo, discount_value = 25 o discount_value = 50.25)

customer_phone

Número de teléfono del comprador – opcional, si se proporciona otro parámetro.

customer_email

Email del comprador

link_expired

Tiempo de validez del enlace de pago – dd.mm.aaaa en formato (por ejemplo, 25.01.2021). Además, Calculadora en el campo se puede indicar así: link_expired = current_date + 2 (el enlace será válido durante 2 días hasta las 00:00).

link_expired

Además, se puede indicar la hora exacta, formato: dd.mm.aaaa hh:mm (por ejemplo, 25.01.2021 12:23). También se pueden usar variables estándar; por ejemplo, para establecer la validez del enlace en 30 minutos: time = current_time + 30 link_expired = "#{current_date} #{time}"

currency

Moneda del pago, por defecto "rub". Lista completa de argumentos:

  • rub

  • usd

  • eur

  • kzt

Este parámetro debe escribirse en minúsculas.

payment_title

Título del pago (hasta 127 caracteres). Si no se indica, se completará automáticamente con el siguiente texto: “Pago de la factura payment_id” (payment_id – identificador del pedido en MaviBot).

payment_description

Resumen breve del pago (hasta 127 caracteres)

locale

Idioma de la página de pago – en-US, fr-XC se muestra en formato, etc. El valor predeterminado es ru-RU. La lista completa puede verse en este enlace

products_for_receipt

cadena de 50 a 4000 caracteres en formato "descripción del pedido - precio - enlace al recurso comprado". Por ejemplo: “Curso ‘Pesca de la brema’, precio 4999 tenge, enlace a la página del curso: https://www.lovilescha.ru/courses/poimai_kilogram/"

Este es un parámetro obligatorio; si no tienes tu propia caja registradora en línea, es necesario para fiscalizar los pagos a través de Prodamus.

payment_sum

(obligatorio) importe del pago

discount_value, customer_phone, customer_email y link_expired las variables también son relevantes para las suscripciones.

Ejemplo de implementación. En el primer bloque configuramos el importe del pago:

En el siguiente paso, en el lugar necesario prodamus_pay_url mostramos el enlace:

prodamus_available_payment_methods variable payment_sum se define antes de publicar. Valores posibles:

AC

Pago con tarjeta emitida en la Federación Rusa

ACkz

Pago con tarjeta de Kazajistán

ACf

Pago con tarjetas de países de la CEI, excepto la Federación Rusa

ACEURNMBX

Pago con tarjeta EUR de todos los países, excepto Rusia y Bielorrusia

SBP

Pago rápido, sin introducir los datos de la tarjeta. Para tarjetas rusas

QW

Monedero Qiwi

PC

YooMoney

GP

Terminal de pago

sbol

Sberbank Online

invoice

Pago por factura

installment

Pago a plazos a través de Prodamus

installment_5_21

Pago a plazos a 3 meses a través de Prodamus

installment_6_28

Pago a plazos a 6 meses a través de Prodamus

installment_10_28

Pago a plazos a 10 meses a través de Prodamus

installment_12_28

Pago a plazos a 12 meses a través de Prodamus

installment_0_0_3

Pago a plazos a 3 meses a través de Tinkoff

installment_0_0_4

Pago a plazos a 4 meses a través de Tinkoff

installment_0_0_6

Pago a plazos a 6 meses a través de Tinkoff

installment_0_0_10

Pago a plazos a 10 meses a través de Tinkoff

installment_0_0_12

Pago a plazos a 12 meses a través de Tinkoff

installment_0_0_24

Pago a plazos a 24 meses a través de Tinkoff

installment_0_0_36

Pago a plazos a 36 meses a través de Tinkoff

credit

Crédito a través de Tinkoff

vsegdada_installment_0_0_4

Pago a plazos a 4 meses a través de «VsegdaDa» (no funciona con available_payment_methods)

vsegdada_installment_0_0_6

Pago a plazos a 6 meses a través de «VsegdaDa»

vsegdada_installment_0_0_10

Pago a plazos a 10 meses a través de «VsegdaDa»

vsegdada_installment_0_0_12

Pago a plazos a 12 meses a través de «VsegdaDa»

vsegdada_installment_0_0_24

Pago a plazos a 24 meses a través de «VsegdaDa»

vsegdada_installment_0_0_36

Pago a plazos a 36 meses a través de «VsegdaDa»

sbrf_installment_0_0_6

Pago a plazos a 6 meses a través de Sberbank

sbrf_installment_0_0_10

Pago a plazos a 10 meses a través de Sberbank

sbrf_installment_0_0_12

Pago a plazos a 12 meses a través de Sberbank

sbrf_installment_0_0_24

Pago a plazos a 24 meses a través de Sberbank

sbrf_installment_0_0_36

Pago a plazos a 36 meses a través de Sberbank

otp_installment_0_0_6

Pago a plazos a 6 meses a través de OTP Bank

otp_installment_0_0_10

Pago a plazos a 10 meses a través de OTP Bank

otp_installment_0_0_12

Pago a plazos a 12 meses a través de OTP Bank

otp_installment_0_0_24

Pago a plazos a 24 meses a través de OTP Bank

otp_installment_0_0_36

Pago a plazos a 36 meses a través de OTP Bank

mts_installment_0_0_6

Pago a plazos a 6 meses a través de MTS Bank

mts_installment_0_0_10

Pago a plazos a 10 meses a través de MTS Bank

mts_installment_0_0_12

Pago a plazos a 12 meses a través de MTS Bank

mts_installment_0_0_24

Pago a plazos a 24 meses a través de MTS Bank

mts_installment_0_0_36

Pago a plazos a 36 meses a través de MTS Bank

monetaworld

Tarjetas de bancos mundiales, excepto Rusia

sbrf_bnpl

Pago a plazos a través de Sber

Múltiples valores separados por una barra vertical permitido. Ejemplo:

prodamus_currency – es otro parámetro adicional que permite mostrar el importe en una moneda específica.

Monedas posibles:

  • kzt – para el tenge

  • eur – para el euro

  • usd – para el dólar

Así, el importe indicado en el enlace estará en la moneda seleccionada.

Callback payment_callback al recibir currency y currency_sum hay que prestar atención a los parámetros, donde se indican la moneda y el importe.

Si no se especifica, irá a una página sin métodos de pago. Los métodos de pago pueden añadirse con soporte. Los métodos añadidos se pueden comprobar en la configuración de la página o en el enlace de pago.

Cómo procesar el resultado

Pago exitoso

Importante: Tras un pago exitoso o fallido, llegarán callbacks al bot, con los que podrás determinar si el pago se realizó con éxito.

Los callbacks en el sistema aparecen como mensajes del usuario, pero el usuario no puede enviarlos. Se presentan como una combinación de clave secreta y estado. Por ejemplo:

o

Después de un pago exitoso prodamus_payment_completed la variable automáticamente True adopta el valor.

Nota: Los callbacks llegan con algo de retraso, por lo que es mejor enviar al usuario un mensaje después de enviarle el enlace:

“Después de realizar el pago, espere a que el pago se complete correctamente.”

Estructura del callback

Para los enlaces creados mediante el botón de Pago o con la función en la Calculadora, después del pago llegará automáticamente un callback al bot. Su composición es:

Por ejemplo:

  • ovg58keefc – clave secreta completa del sistema de pagos

  • _success – el resultado del procesamiento de la solicitud (pago exitoso)

Aplicación práctica

El pago exitoso puede procesarse mediante un bloque condicional y mostrar al usuario el mensaje correspondiente.

El tipo de comparación debe ser "Full match" / "Coincidencia total"

Para volver a realizar el pago, es necesario payment_sum poner la variable a cero y eliminar el enlace creado previamente. Solo entonces payment_sum asignar un nuevo valor a la variable y obtener el enlace actualizado.

Desactivación/reactivación de la suscripción

Además, en el sistema Prodamus hay notificaciones sobre si la suscripción ha sido activada o detenida:

«La suscripción fue desactivada por el usuario» – si la suscripción se detiene manualmente (por ejemplo, al darse de baja). Este mensaje puede llegar antes de que finalice el período actualmente pagado. La acción depende de tu decisión: ignorar, poner bajo control o intentar recuperar al usuario.

«La suscripción fue reactivada por el usuario» – la suscripción se ha restaurado. Este mensaje puede llegar si el usuario restaura la suscripción antes de que finalice el período actualmente pagado. La acción depende de tu decisión: ignorar o sacarlo de la lista de monitoreo.

«Desactivación de la suscripción» – si la suscripción se detiene después de varios pagos fallidos.

Guardar valores del callback

Después de recibir la notificación de pago exitoso payment_callback se escribirá en la variable un callback de Prodamus, que contendrá todos los datos del pago. Estos datos pueden guardarse y usarse de la forma que necesites.

Ejemplo de callback:

Al crear el enlace product_name y payment_description se pueden indicar variables. Entonces, cuando llegue el callback, se pueden obtener así:

Atención: payment_sum se asigna el último valor a la variable, de las variables opcionales que está después: payment_description, product_name.

El importe se puede obtener así:

Callbacks disponibles

Además de los callbacks principales de pago exitoso, en el chat llegarán los siguientes mensajes que el usuario no ve:

callbacks

  • El suscriptor desactivó la suscripción (más detalles aquí)

  • El suscriptor reactivó la suscripción (más detalles aquí)

  • La suscripción ha finalizado

  • Pago no exitoso: nota con explicación (en la captura de pantalla de arriba)

  • Notificación de próximo cargo: fecha y hora del próximo cargo

  • Solicitud de pago a plazos con estado

Ejemplos de callbacks en el diálogo con el cliente

  • El suscriptor desactivó la suscripción

  • El suscriptor reactivó la suscripción

  • La suscripción ha finalizado

  • Pago no exitoso: Fondos insuficientes.

  • Pago no exitoso: La tarjeta ha caducado.

  • Pago no exitoso: Se superó el límite de la tarjeta.

  • Pago no exitoso: La tarjeta se ha perdido

  • Pago no exitoso: Error del sistema

  • Pago no exitoso: Operación rechazada. Contacta al banco emisor de la tarjeta.

  • Pago no exitoso: Operación denegada por el banco emisor.

  • Pago no exitoso: Operación denegada por el banco.

  • Notificación de próximo cargo - dd.mm.aaaa hh:mm

  • Solicitud de pago a plazos aprobada

  • Solicitud de pago a plazos cancelada

  • Solicitud de pago a plazos rechazada

Si lo deseas, puedes configurar el envío de cualquier mensaje al usuario. Por ejemplo, enviar un mensaje si un pago automático falla.

Se pueden configurar bloques de respuesta para un mensaje por un motivo concreto de pago fallido de la siguiente manera:

Para enviar un mensaje a todos los pagos fallidos, independientemente del motivo, se puede configurar así:

En todos los callbacks, si el texto «Pago fallido» está presente, se enviará al usuario un mensaje con el texto que hayas establecido.

Cómo pagar una suscripción

Cómo crear una suscripción

Para crear una suscripción, primero producto de suscripción debe crearse. Instrucciones completas: Cómo crear y configurar una suscripción

Después, el ID del producto de suscripción se copia. Por ejemplo, abajo se muestra de dónde obtenerlo:

Crear un producto de suscripción

Para crear el enlace de pago de la suscripción, prodamus_subscription debe establecerse en la variable ID del producto de suscripción. Después de eso, automáticamente prodamus_pay_url variable.

Traducción al kazajo (estilo empresarial):

prodamus_pay_url la variable se puede mostrar en pantalla como enlace o colocarla en un botón con el texto «Pagar». Ejemplo de enlace: https://payform.kz/7p3JR8/

El procesamiento del resultado se realiza igual que en un pago único (como has leído arriba).

Después de una suscripción exitosa, al usuario se le añade la customer_phone variable introducida durante el pago. El número de teléfono es necesario para gestionar la suscripción.

Si customer_email no se proporciona, para gestionar la suscripción customer_phone es obligatorio.

get_prodamus_subscription_url cómo crear un enlace para una suscripción con la función

Veamos otro método para crear un enlace de pago de suscripción para un producto.

  1. En el panel de Prodamus se crea un producto de suscripción. La guía completa se puede ver en el enlace: Cómo crear y configurar una suscripción

  2. Después, el ID del producto de suscripción se copia. Por ejemplo, abajo se muestra de dónde obtenerlo:

Crear un producto de suscripción

Para obtener el enlace de pago de un producto por suscripción, en la Calculadora indicamos la función

get_prodamus_subscription_url(subscription_id, product_name, expired, customer_phone, customer_email, discount, description, extra_params, products_for_receipt)

Ejemplo 1: Enlace de pago para un producto por suscripción

Si hay un error en el bloque al obtener un enlace mediante varias funciones, el valor del error error_payment_func en la variable se escribirá.

El error se escribe en la Calculadora según la última función.

Cómo gestionar el estado de la suscripción

Este método es solo para suscripciones reales; en el modo demo no hay vinculación de tarjeta.

Para gestionar la suscripción, necesariamente customer_phone o customer_email debe pasarse uno de los parámetros.

Para cancelar la suscripción del usuario, hay que crear un bloque y llamar a la siguiente función: delete_subscription_prodamus

Ejemplo de parámetros:

  • url – URL del formulario de pago, tomada de los ajustes del constructor

  • secret_key – clave secreta tomada de los ajustes

  • id_subscription – ID del producto de suscripción

  • customer_phone – teléfono del propietario de la suscripción

  • switcher – gestión de la suscripción: 0 – detener la suscripción, 1 – reactivar la suscripción

  • profile_id – ID del perfil en el sistema Prodamus

Nota: Si llega el ID del perfil, se profile_id guardará en la variable. profile_id a la función customer_phone o customer_email y puede usarse en su lugar para detener la suscripción.

Ejemplo: configuración de bloques de suscripción

Tenga en cuenta que la función status devuelve el estado, puede guardarlo y procesarlo como desee. Al detener o reactivar correctamente la suscripción, status = ok se obtendrá.

Función para gestionar la suscripción

prodamus_subscription_switch_status(subscription_id, switcher, customer_phone, customer_email, profile_id) Parámetros:

subscription_id – ID del producto de suscripción

switcher – gestión de la suscripción: 0 – detener la suscripción, 1 – reactivar la suscripción

customer_phone – teléfono del propietario de la suscripción; opcional, si se especifica customer_email

customer_email – dirección de email del propietario de la suscripción; opcional, si se especifica customer_phone

profile_id – ID del perfil en el sistema Prodamus

Ejemplo de uso de la función prodamus_subscription_switch_status

Traducción al kazajo (estilo empresarial):

Ejemplo 1: customer_phone parámetro proporcionado, customer_email omitido:

Ejemplo 2: customer_email parámetro proporcionado, customer_phone omitido:

La función devuelve ok si todas las operaciones se completan correctamente o la descripción del error en caso de fallo.

Gestión de descuentos en la suscripción

Esta función establece el importe del descuento para los siguientes pagos de la suscripción. El descuento limitado o ilimitado puede aplicarse a un número de pagos.

Parámetros:

  • subscription_id – ID de la suscripción

  • discount – número decimal con dos dígitos después del punto; el valor debe ser mayor que cero y no superar el coste base de la suscripción

  • customer_phone – número de teléfono del cliente, formato: +79999999999 (opcional, si customer_email la variable; aparece después del primer pago)

  • num – número de pagos a los que se aplicará el descuento (opcional; si no se especifica, el descuento se aplicará a todos los pagos)

  • profile_id – ID del perfil en el sistema Prodamus

Si la solicitud se ejecuta correctamente, la función 'ok' devolverá; si ocurre un error, la función devolverá la descripción del error.

¡El importe del descuento y el intervalo solo se sobrescribirán si se vuelve a llamar a la función con nuevos valores!

Ejemplos:

1. Conceder un descuento de 1₽ en todos los siguientes pagos automáticos (el número de teléfono no se indica, porque se toma automáticamente de la variable customer_phone ; el importe del descuento se aplica por defecto a todo el período de la suscripción):

2. Ejemplo de conceder un descuento de 2₽ en los siguientes 3 pagos (el número de teléfono se proporciona entre comillas vacías, porque se toma automáticamente de la variable customer_phone ):

3. Ejemplo de mostrar un descuento con decimales (el separador es un punto, los valores se indican sin comillas), el número de teléfono puede pasarse mediante una variable.

r = prodamus_subscription_discount(#{prodamus_subscription}, 10.25, #{customer_phone}, 3)

Cómo establecer la fecha del próximo pago de la suscripción

Con este método se puede posponer la fecha del próximo pago de la suscripción. La fecha solo puede posponerse al «futuro» desde la fecha actual del próximo pago, aumentando así el período de participación en el club.

Por ejemplo, esto puede aplicarse como bono para los suscriptores.

Para ello, debe utilizar la siguiente función:

Parámetros:

  • subscription_id – identificador de la suscripción

  • date – fecha en formato dd.mm.aaaa hh:mm o dd.mm.aaaa; si solo se proporciona dd.mm.aaaa, la hora será 00:00

  • customer_phone – opcional; si no se especifica, customer_phone se toma de la variable; si no se encuentra, la función no funcionará

  • profile_id – ID del perfil en el sistema Prodamus

Cómo enviar parámetros a Prodamus

Para enviar los parámetros necesarios (por ejemplo, la fecha de inicio de la suscripción, desactivar el pago a plazos, etc.) al sistema Prodamus, añada al nombre de la variable prodamus_ el prefijo.

Después, al generar el enlace de pago, los parámetros de esta variable se enviarán automáticamente al sistema de pago.

Cómo probar el pago

¡Solo probamos el pago!

Para que no se cargue dinero de su cuenta al configurar la integración y los embudos de pago, pueden usarse tarjetas de prueba.

Primero cambie su página de pago al MODO DEMO ⤵ No olvide pulsar el botón «Guardar».

Para realizar un pago de prueba, pueden usarse cuentas de prueba.

Tarjetas de prueba de Sberbank:

MIR Número de tarjeta: 2202 2050 0001 2424 Fecha de caducidad: 05/35 Código de verificación en el reverso (CVV): 669

MasterCard Número de tarjeta: 5469 9801 0004 8525 Fecha de caducidad: 05/26 Código de verificación en el reverso (CVV): 041 Código de verificación 3-D Secure: 111111

Visa Número de tarjeta: 4006 8009 0096 2514 Fecha de caducidad: 05/26 Código de verificación en el reverso (CVV): 941 Código de verificación 3-D Secure: 111111

❗️Al realizar pagos con cuentas de prueba, todos los embudos e integraciones configurados funcionan igual que en un pago normal❗️

Formulario verificado

Para aceptar pagos reales, el formulario debe pasar al modo de funcionamiento. Es decir, el selector del modo demo rojo claro debe establecerse en estado.

Última actualización