Prodamus (KZ)

Cómo conectar Prodamus

Para conectar Prodamus, necesitará la URL del formulario de pago y la 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, donde también debe indicar la URL a la que se enviarán las notificaciones (notification).

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 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 puede elegir el modo de funcionamiento del formulario de pago: modo demo sin pagos o modo de aceptación de pagos.

La dirección para notificaciones debe indicarse en dos lugares 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 notificaciones: https://chatter.mavibot.ai/prodamus_callback/result

Para configurar el trabajo con pagos por suscripción, «Suscripciones» vaya a la pestaña y especifique la dirección para notificaciones:

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

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

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

Después solo queda introducir los datos mencionados arriba en el formulario:

¡Importante! Al indicar la URL del formulario de pago, https:// no lo añada.

Así queda completada la conexión. Ahora veamos cómo usar esta funcionalidad.

Cómo crear un enlace de pago

Botón con la función «Pagar»

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

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

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

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

Para crear un enlace de pago, en la configuración del botón debe indicar los parámetros obligatorios: «Importe», «Nombre del producto», así como el parámetro «Contenido pagado» — si no tiene su propia caja online y desea recibir un recibo de Prodamus.

Al pasar a la página de pedido, la información sobre el producto y su precio se muestra de antemano, y el cliente solo introduce sus datos de contacto.

Si en la configuración del botón se indica el Email y/o 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 el mensaje del botón con enlace de pago.

Campo «Función» — para crear un botón que dé un enlace de pago, elegimos 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) — debe 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ínelas o sustitúyalas por comillas simples.

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

Menú «Información adicional» — al hacer clic en este botón, se abren campos adicionales para crear un 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 recurrente)

• Contenido pagado

Casilla «Notificar al hacer clic» — puede marcarse para controlar el paso al enlace de pago. En este caso, al hacer clic en el botón, llegará un mensaje al diálogo del cliente en Sellbot indicando que se ha seguido el enlace.

A partir de este mensaje se puede configurar la lógica de funcionamiento posterior del bot. La mayoría de los sistemas de pago admiten cajas online en la nube, necesarias conforme a la ley 54-FZ.

Lea en el sitio del sistema de pago elegido las particularidades de la emisión de recibos para no meterse en problemas con la inspección fiscal.

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

Página de pago: en el botón solo están rellenados los parámetros básicos

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 en el Datos adicionales campo.

Campo «Descuento» — aquí puede indicar el importe del descuento en rublos o en rublos y céntimos. Para indicar céntimos, use un punto como separador: 50.99 En la página de pago, en el Importe a pagar campo se mostrará el descuento tenido en cuenta y el precio original del producto aparecerá tachado.

Campo «Variable del email del comprador» (opcional, si se indica el número de teléfono) — aquí se especifica el Email del usuario (cliente). También puede usar una variable donde se haya guardado el Email, por ejemplo: #{email}

Campo «Variable del número de teléfono del comprador» (opcional, si se indica el Email) — aquí puede usar una variable con el número de teléfono del comprador, formato: 79000000000, por ejemplo: #{phone} Debe haber Email y/o teléfono obligatoriamente.

Campo «Tiempo de validez del enlace» — la fecha puede indicarse en el formato dd.mm.aaaa hh:mm (por ejemplo, 25.01.2021 11:00) o puede establecer el plazo de expiración del enlace mediante una variable. Por ejemplo: #{link_expired}

Campo «ID del producto para suscripción» — indique el valor del ID del producto para crear un pago recurrente. Para crear una suscripción, es necesario crear un producto de suscripción. Instrucciones completas: Creación y configuración de suscripciones Prodamus Si se indica el ID del producto para la suscripción, el importe del pago no se tiene en cuenta. 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 indica el ID del producto para la suscripción, en el callback de un pago exitoso se devolverá el ID de este producto.

Campo «Contenido pagado» (condicionalmente obligatorio) — estos datos son necesarios para la fiscalización del pago a través de Prodamus, si no tiene su propia caja online. En este campo se indica la descripción de la compra, el precio y el enlace al contenido. Por ejemplo: Curso «Tejido de trenzas», 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 indica 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 se encuentra en el diálogo, no será posible realizar el pago, y se le mostrará el siguiente mensaje:

El período de validez del enlace debe ser posterior a la fecha actual; de lo contrario, el cliente no podrá pagar con este enlace.

2. Cuando el usuario solicita el enlace, si ahora no está activo En este 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: el período de validez del enlace debe ser posterior a la fecha actual".

Para que el usuario pueda pagar correctamente, se recomienda procesar este caso adicionalmente.

Cree el siguiente bloque condicional: Si llega el siguiente mensaje: error_payment_button == "Error: el período de validez del enlace debe ser posterior a la fecha actual"

Entonces muestre el siguiente texto: "Lo sentimos, no llegó a pagar a tiempo; el enlace de pago dejó de ser válido".

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

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

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

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

error_payment_button variable del cliente se crea automáticamente si se produce un error al crear el botón. En esta variable se escribirá el texto del error o la respuesta de error recibida del sistema de pago.

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

Cómo procesar el resultado

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

Por ejemplo: ovg58keefc_success 44donde:

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

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

• 44 — importe del pago

El usuario NO VE los callbacks (mensajes) del sistema de pago. Solo se muestran en la pestaña «Clientes»

y son visibles para el operador. Ejemplo de uso: Paso 1. Añadimos botones con la función «Pagar» al bloque «Botón con pagar». Paso 2. Indicamos el callback en el campo de condición de enlace que lleva desde este bloque al bloque «Pago exitoso». Del mismo modo, si en la condición del bloque «Condición inicial» se indica el callback de pago exitoso, el funcionamiento será análogo.

Importante: Elegir «Coincidencia exacta» o «Por palabras clave».

❗️Si decide comprobar el pago por la flecha indicada en una condición exacta, piense cuidadosamente en la lógica de su esquema. Si el cliente deja el bloque con la condición por callback, no habrá transición al bloque. Este método de comprobación es mejor usarlo solo si el cliente no cambia de posición en el embudo.

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

Callback sobre 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 le llega un CALLBACK AUTOMÁTICO que consta de los primeros 10 caracteres de la clave secreta del sistema de pago, _success y del ID del producto de suscripción.

Por ejemplo: 214009eefc_success 618117donde:

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

• _success — 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 erróneo En caso de error al realizar el pago, al bot le llega un CALLBACK AUTOMÁTICO que consta de los primeros 10 caracteres de la clave secreta del sistema de pago, _fail la palabra y el importe del pago.

Por ejemplo: ovg58keefc_fail 44donde:

• 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 — importe del pago

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

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

Por ejemplo: ovg58keefc_different_amounts 123456donde:

• 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 — ID ú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 se puede utilizar. En el campo Calculadora asignamos el valor de esta función a la variable: get_prodamus_payment_url.

El nombre de la variable lo eliges tú. En las capturas se muestran ejemplos de asignación de nombres a variables.

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

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

Calculadora

Ejemplo 1:

Descripción de los parámetros

Ejemplo

Si hay varias funciones para obtener enlaces en el bloque y se produce un error, el valor del error se escribirá en error_payment_func variable.

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

payment_sum variable y creación de un enlace mediante parámetros adicionales

Atención: payment_sum el valor se asigna a la variable desde 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 Calculadora payment_sum basta con establecer el valor de la variable. Después de esto, automáticamente prodamus_pay_url aparecerá la variable.

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

Esta variable se puede mostrar en un mensaje como enlace o colocar en un botón con el texto «Pagar».

payment_sum Antes de declarar la variable, se pueden indicar estas variables opcionales:

Parámetros de la función	Descripción del parámetro
product_name	Nombre del producto (si no se indica, se completará automáticamente con "Pago de la factura order_id") — en la captura de pantalla de abajo se muestra dónde se indica.
payment_description	Descripción del producto (si no se indica, se rellenará automáticamente con 'Pago de la factura order_id' se completará) — en la captura de pantalla 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 indica otro parámetro.
customer_email	Correo electrónico 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 pueden utilizarse variables estándar, por ejemplo, para establecer la validez del enlace durante 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 indicarse 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	Descripción breve del pago (hasta 127 caracteres)
locale	Idioma de la página de pago — en-US, fr-XC y similares. 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 adquirido". Por ejemplo: “Curso ‘Pesca de dorada’, precio 4999 tenge, enlace a la página del curso: https://www.lovilescha.ru/courses/poimai_kilogram/" Este parámetro obligatorio es necesario para fiscalizar el pago a través de Prodamus si no tiene su propia caja online.
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 establecemos el importe del pago:

En el siguiente paso mostramos el prodamus_pay_url enlace donde sea necesario:

prodamus_available_payment_methods variable payment_sum se define antes de declararla. 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	Qiwi wallet
PC	Юmoney
GP	Terminal de pago
sbol	Sberbank Online
invoice	Pago mediante factura
installment	Pago a plazos a través de Prodamus
installment_5_21	Pago a plazos durante 3 meses a través de Prodamus
installment_6_28	Pago a plazos durante 6 meses a través de Prodamus
installment_10_28	Pago a plazos durante 10 meses a través de Prodamus
installment_12_28	Pago a plazos durante 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 durante 4 meses a través de Tinkoff
installment_0_0_6	Pago a plazos durante 6 meses a través de Tinkoff
installment_0_0_10	Pago a plazos durante 10 meses a través de Tinkoff
installment_0_0_12	Pago a plazos durante 12 meses a través de Tinkoff
installment_0_0_24	Pago a plazos durante 24 meses a través de Tinkoff
installment_0_0_36	Pago a plazos durante 36 meses a través de Tinkoff
credit	Crédito a través de Tinkoff
vsegdada_installment_0_0_4	Pago a plazos durante 4 meses a través de “VsegdaDa” (no funciona con available_payment_methods)
vsegdada_installment_0_0_6	Pago a plazos durante 6 meses a través de “VsegdaDa”
vsegdada_installment_0_0_10	Pago a plazos durante 10 meses a través de “VsegdaDa”
vsegdada_installment_0_0_12	Pago a plazos durante 12 meses a través de “VsegdaDa”
vsegdada_installment_0_0_24	Pago a plazos durante 24 meses a través de “VsegdaDa”
vsegdada_installment_0_0_36	Pago a plazos durante 36 meses a través de “VsegdaDa”
sbrf_installment_0_0_6	Pago a plazos durante 6 meses a través de Sberbank
sbrf_installment_0_0_10	Pago a plazos durante 10 meses a través de Sberbank
sbrf_installment_0_0_12	Pago a plazos durante 12 meses a través de Sberbank
sbrf_installment_0_0_24	Pago a plazos durante 24 meses a través de Sberbank
sbrf_installment_0_0_36	Pago a plazos durante 36 meses a través de Sberbank
otp_installment_0_0_6	Pago a plazos durante 6 meses a través de «OTP Bank»
otp_installment_0_0_10	Pago a plazos durante 10 meses a través de «OTP Bank»
otp_installment_0_0_12	Pago a plazos durante 12 meses a través de «OTP Bank»
otp_installment_0_0_24	Pago a plazos durante 24 meses a través de «OTP Bank»
otp_installment_0_0_36	Pago a plazos durante 36 meses a través de «OTP Bank»
mts_installment_0_0_6	Pago a plazos durante 6 meses a través de «MTS Bank»
mts_installment_0_0_10	Pago a plazos durante 10 meses a través de «MTS Bank»
mts_installment_0_0_12	Pago a plazos durante 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 internacionales, excepto Rusia
sbrf_bnpl	Pago a plazos a través de Sber

Valores múltiples separados por barra vertical se permite dividir. Por ejemplo:

prodamus_available_payment_methods = "AC|PC|QW"

prodamus_currency – este es otro parámetro adicional que permite mostrar el importe en una determinada moneda.

Monedas posibles:

• kzt – para tenge

• eur – para euro

• usd – para dólar

De este modo, el importe indicado en el enlace estará en la moneda seleccionada.

Callback payment_callback al recibir currency y currency_sum es necesario 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 se pueden añadir con soporte. Los métodos añadidos se pueden ver en la configuración de la página o probando mediante un enlace de pago.

Cómo procesar el resultado

Pago exitoso

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

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

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success

o

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_fail

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

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

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

---

Estructura del callback

Para los enlaces creados mediante el botón Pagar o la función del Calculador, después del pago llega automáticamente un callback al bot. Su contenido es:

<clave_secreta>_success <importe_del_pago>

Por ejemplo:

ovg58keefc_success

• ovg58keefc – clave secreta completa del sistema de pagos

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

---

Uso práctico

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

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

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

Desactivación/reactivación de suscripción

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

«La suscripción fue desactivada por el usuario» – si la suscripción se detuvo manualmente (por ejemplo, al cancelar la suscripción). Este mensaje puede llegar antes de que termine el periodo actual ya pagado. La acción depende de su decisión: ignorar, poner en seguimiento 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 termine el periodo actual ya pagado. La acción depende de su decisión: ignorar o quitar de la lista de seguimiento.

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

Guardar valores del callback

Después de recibir la notificación de pago exitoso payment_callback se escribe en la variable un callback de Prodamus que contiene todos los datos del pago. Estos datos pueden guardarse y utilizarse como usted necesite.

Ejemplo de callback:

{
  "date": "2021-03-30T11:44:43+03:00",
  "order_id": "757679",
  "order_num": "",
  "domain": "demo.payform.ru",
  "sum": "14.50",
  "customer_phone": "[phone]",
  "customer_extra": "Producto",
  "payment_type": "Tarjeta plástica Visa, MasterCard, MIR",
  "commission": "3.5",
  "commission_sum": "0.51",
  "attempt": "1",
  "discount_value": "10.5",
  "products[0][name]": "Acceso a materiales de formación",
  "products[0][price]": "14.50",
  "products[0][quantity]": "1",
  "products[0][sum]": "14.50",
  "payment_status": "success",
  "payment_status_description": "Pago exitoso",
  "payment_init": "manual"
}

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

product = get(payment_callback,'products[0][name]')
description = get(payment_callback,'customer_extra')

Atención: payment_sum a la variable de las variables no obligatorias que se encuentran después: payment_description, product_name.

El importe se puede obtener así:

summa = get(payment_callback, 'sum')

Callbacks disponibles

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

callbacks

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

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

• Suscripción finalizada

• Pago no exitoso - nota con explicación (en la captura anterior)

• 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

• Suscripción finalizada

• Pago no exitoso - Fondos insuficientes.

• Pago no exitoso - La tarjeta ha caducado.

• Pago no exitoso - Se ha superado el límite de la tarjeta.

• Pago no exitoso - Tarjeta perdida

• Pago no exitoso - Error del sistema

• Pago no exitoso - Operación rechazada. Póngase en contacto con el banco emisor de la tarjeta.

• Pago no exitoso - Rechazo de la operación por el banco emisor.

• Pago no exitoso - Rechazo de la operación 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 desea, puede configurar el envío de cualquier mensaje al usuario. Por ejemplo, enviar una notificación en caso de fallo de un pago automático.

Las respuestas a los bloques de mensajes por un motivo específico de fallo de pago se pueden configurar de la siguiente manera:

Para enviar un mensaje a todos los pagos fallidos, independientemente del motivo, se puede configurar de la siguiente manera:

En todos los callbacks, si el texto contiene «Pago fallido» entonces se enviará al usuario un mensaje con el texto que usted haya definido.

Cómo realizar un pago mediante suscripción

Cómo crear una suscripción

Para crear una suscripción, primero es necesario crear un producto de suscripción . Instrucciones completas: Cómo crear y configurar una suscripción

Luego copiamos el ID del producto de suscripción. Por ejemplo, abajo se muestra de dónde obtenerlo:

Creación de un producto de suscripción

Para crear un enlace de pago de suscripción, prodamus_subscription a la variable del producto de suscripción ID debe asignarse. Después, automáticamente prodamus_pay_url aparecerá la variable.

Traducción al español (estilo formal):

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

El procesamiento del resultado se realiza igual que en el pago único (como se explicó arriba).

Después de una suscripción exitosa, al usuario se le añade el 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 de suscripción con la función

Veamos otra forma de 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 puede verse en este enlace: Cómo crear y configurar una suscripción

2. Luego copiamos el ID del producto de suscripción. Por ejemplo, abajo se muestra de dónde obtenerlo:

Creación de un producto de suscripción

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

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

Calculadora

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

Descripción de los parámetros

Ejemplo de código para copiar

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

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 solo es para suscripciones reales; en el modo demo no hay vinculación de tarjeta.

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

Para dar de baja al usuario de la suscripción, es necesario crear un bloque y llamar a la siguiente función: delete_subscription_prodamus

Ejemplo de parámetros:

{
  "customer_phone": "#{customer_phone}",
  "id_subscription":"#{prodamus_subscription}",
  "url":"https://demo.payform.ru/",
  "secret_key":"453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66",
  "switcher":"0",
  "profile_id":"12345"
}

• url – URL del formulario de pago, obtenida de la configuración en el constructor

• secret_key – clave secreta obtenida de la configuración

• 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 – cancelar suscripción, 1 – reactivar suscripción

• profile_id – ID del perfil en Prodamus

Nota: Si llega el ID del perfil, se guarda en la variable profile_id . profile_id a la función customer_phone o customer_email en su lugar y cancelar la suscripción.

Ejemplo: configuración de bloques de suscripción

Tenga en cuenta que la función status devuelve, y puede guardarse y procesarse como usted quiera. Al cancelar o reactivar la suscripción con éxito, status = ok será.

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 – cancelar suscripción, 1 – reactivar suscripción

customer_phone – teléfono del propietario de la suscripción; no es obligatorio si se especifica customer_email

customer_email – correo electrónico del propietario de la suscripción; no es obligatorio si se especifica customer_phone

profile_id – ID del perfil en Prodamus

Ejemplo de uso de la función prodamus_subscription_switch_status

Traducción al español (estilo formal):

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

stat = prodamus_subscription_switch_status('618117', '0', '75431312321')

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

stat = prodamus_subscription_switch_status('618117', '0', '', '[email protected]')

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

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 según el número de pagos.

prodamus_subscription_discount(subscription_id, discount, customer_phone, num, profile_id)

Parámetros:

• subscription_id – ID de la suscripción

• discount – número decimal con dos decimales tras el 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: [phone] (opcional, si customer_email la variable está presente; 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 aplica a todos los pagos)

• profile_id – ID del perfil en Prodamus

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

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

Ejemplos:

1. Dar un descuento de 1₽ a todos los siguientes pagos automáticos (no se especifica el número de teléfono, ya que se toma automáticamente de la customer_phone variable; el importe del descuento, por defecto, se aplica a todo el periodo de la suscripción):

r = prodamus_subscription_discount('624034', '1')

2. Ejemplo de descuento de 2₽ para los siguientes 3 pagos (el número de teléfono se proporciona con comillas vacías, ya que se toma automáticamente de la customer_phone variable):

r = prodamus_subscription_discount('624034', '2', '', '3')

3. Ejemplo de descuento con decimal (el separador es el punto, los valores se indican sin comillas), el número de teléfono puede darse mediante 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 moverse «al futuro» desde la fecha de próximo pago actualmente establecida, lo que permite ampliar el periodo de participación en el club.

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

Para ello es necesario usar la siguiente función:

prodamus_subscription_payment_date(subscription_id, date, customer_phone, profile_id)

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 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 el prefijo prodamus_ al nombre de la variable.

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

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, puede usar 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, puede usar 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 pagar con cuentas de prueba, todos los embudos e integraciones configurados funcionan igual que con un pago normal❗️

Formulario probado

Para aceptar pagos reales, el formulario debe cambiarse al modo de trabajo. Es decir, el interruptor del modo demo debe ponerse en rojo claro estado.