Prodamus (BLR)

Disponible solo en la tarifa "Infobiz".

Cómo conectar Prodamus

Para conectar Prodamus, necesitará la URL del formulario de pago y la clave secreta.

URL del formulario de pago la obtiene después del registro, tiene la forma: demo.payform.ru

La clave secreta puede obtenerse en el área personal; allí también debe indicar la dirección URL para las notificaciones.

Clave secreta en la configuración del formulario del área personal del sistema de pagos "Prodamus"

Instrucciones detalladas sobre cómo hacerlo: https://help.prodamus.ru/payform.ru-onlain-oplaty/prochee/url-dlya-uvedomlenii-i-sekretnyi-klyuch

Dirección para las notificaciones: https://chatter.salebot.pro/prodamus_callback/result

Esta dirección debe configurarse en dos lugares.

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

La dirección para las notificaciones debe configurarse en la configuración del sistema de pagos en dos lugares: pestaña Configuración del formulario - para pagos normales y pestaña Suscripciones - para pagos por suscripción.

Dirección para las notificaciones: https://chatter.salebot.pro/prodamus_callback/result

Para configurar el trabajo con pagos por suscripción vaya a la pestaña Suscripciones e indique la dirección para las notificaciones: https://chatter.mavibot.ai/prodamus_callback/result

¡Tenga en cuenta! Después de introducir la URL, asegúrese de pulsar el botón «Guardar».

Para conectar Prodamus es necesario ir a la sección "Cobro"

A continuación, solo hay que indicar en el formulario los datos de los que hablamos arriba:

¡IMPORTANTE! la url del formulario de pago se indica SIN https://

Con esto finaliza la conexión. Ahora veamos cómo usar esta funcionalidad.

Cómo generar un enlace de pago

Generar un enlace de pago en el bloque se puede DE UNA DE las formas disponibles:

• Botón con la función Pago o

• Función get_prodamus_payment_url en la Calculadora o

• Creación de un enlace mediante la variable payment_sum y parámetros adicionales (versión obsoleta que aún funciona)

Botón con la función Pago

El enlace de pago se puede crear en el botón con la función "Pago". En este artículo se explica cómo crear ese botón

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

Parámetros obligatorios del botón Pago para Prodamus

Para generar el enlace de pago en la configuración del botón es necesario indicar parámetros obligatorios "Importe", "Nombre del producto", así como el parámetro "Contenido pagado", si usted no tiene su propia caja online y quiere recibir el recibo de Prodamus.

Al pasar a la página de pago, ya quedará indicada de antemano la información sobre el producto y su coste; al cliente solo le quedará indicar sus datos de contacto. Si en la configuración del botón indica el email y/o el teléfono del usuario, en la página de pago se mostrarán los datos del pagador y la información sobre el producto y su coste.

Ventana de configuración del botón

campo Texto. Este texto se mostrará en el botón con el enlace de pago en el mensaje

campo Función. Para crear un botón para entregar un enlace de pago, elegimos la función Pago

campo Sistema de pago. En la lista se muestran los sistemas de pago conectados al proyecto

Si no hay sistemas de pago conectados al proyecto, este tipo de botón no estará disponible

campo Nombre del producto (obligatorio). En este campo debe indicar el nombre del producto. Cuanto más preciso sea el nombre del producto, mejor. Por ejemplo: no Teléfono, sino Smartphone Xiaomi modelo ...

NO SE PUEDE usar comillas dobles en el nombre del producto: elimínelas o sustitúyalas por comillas simples.

campo Importe (obligatorio). En este campo indicamos el precio del producto.

menú Información adicional. Al hacer clic en este botón se abrirán campos adicionales para generar el enlace

• Descripción del pedido

• Descuento en rublos

• Variable con el email del comprador

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

• Tiempo de vida del enlace

• ID del producto para suscripción (para crear pagos automáticos)

• Contenido pagado

casilla con notificación al hacer clic. Para rastrear la transición por el enlace de pago, puede marcar la casilla. En ese caso, al hacer clic en el botón, llegará a la conversación con el cliente en Salebot una notificación de que se ha realizado la transición por el enlace

Callback después de que el cliente siga el enlace

A esta notificación se le puede configurar la lógica de funcionamiento posterior del bot.

Muchos sistemas de pago admiten cajas online en la nube; son necesarias por la Ley 54-FZ. Lea las características de emisión de recibos en el sitio web del sistema de pago elegido para no meterse en una situación incómoda con la inspección fiscal.

Y así es como se ve la página de pago que se abre al seguir el enlace del botón Pago:

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

Parámetros adicionales para generar el enlace de pago

campo Descripción del pedido. La información indicada en este campo se mostrará en la página de pago en el campo Datos adicionales

campo Descuento. En este campo puede indicar el importe del descuento en rublos o rublos con céntimos. Para indicar un importe con céntimos, usamos un punto como separador: 50.99 En la página de pago, en el campo Importe a pagar, se indicará el descuento aplicado y el precio principal del producto aparecerá tachado.

Campo Variable con el email del comprador (opcional, si se ha pasado el número de teléfono) En este campo se indica el email del usuario (cliente). Puede indicar la variable en la que se almacena el email del usuario.

Por ejemplo, #{email}

Campo Variable con el número de teléfono del comprador (opcional, si se ha pasado el email). En este campo puede indicar la variable en la que está guardado el número de teléfono del comprador en formato 79000000000 Por ejemplo, #{phone}

Debe haber obligatoriamente email y/o teléfono

campo Tiempo de vida del enlace. Se puede indicar una fecha en formato dd.mm.aaaa hh:mm (por ejemplo 25.01.2021 11:00) o usar variables para asignar el plazo de caducidad del enlace. Ejemplo de uso de la variable: #{link_expired}

campo ID del producto de suscripción. Para realizar un pago automático, pase el valor del ID del producto. Para crear una suscripción, debe crear un producto de suscripción.

Instrucciones detalladas sobre cómo crear un producto para suscripción: https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski

Si se pasa el valor del ID del producto de suscripción, el importe del pago no se tiene en cuenta. Los datos del producto se obtendrán de la ficha del producto en el panel de Prodamus

El número de teléfono indicado al pagar será necesario para gestionar la suscripción.

Si se pasa ID del producto de suscripción, entonces en el callback al realizarse correctamente el pago se transmitirá el ID de ese producto

Campo Contenido pagado (condicionalmente obligatorio). Los datos son necesarios para la fiscalización del pago mediante Prodamus, si no tiene su propia caja online. En este campo debe indicar la descripción de la compra, su precio y un enlace al recurso con el contenido.

Por ejemplo: Curso ‘Trenzado de trenzas’, precio 3000 rublos, enlace a la página del curso: https://nbu.su/krasota/master-po-pleteniyu-kos/?yclid=13602995275739430911.

Estos datos son necesarios para su envío a la FNS.

Botón con la función de pago

Si indica el tiempo de vida del enlace, entonces en caso de

1. Cuando el usuario solicitó el enlace de pago dentro de su periodo activo (es decir, su tiempo de vida aún no ha terminado) y este está en la conversación, no podrá pagar y tendrá una notificación del siguiente tipo:

El plazo de validez del enlace debe ser posterior a la fecha actual; de lo contrario, por un enlace así el cliente tampoco podrá pagar.

2. Cuando el usuario solicita el enlace y este ya no está activo En ese caso, el botón simplemente no aparecerá. Y en las variables del cliente aparecerá la variable "error_payment_button", que contiene el siguiente valor: "Error: El plazo de validez del enlace debe ser posterior a la fecha actual".

Para que el usuario pueda pagar correctamente, conviene además procesar este caso.

¿Cómo hacerlo?

Cree un bloque con una condición en el que indique que, si llega una notificación de este tipo, error_payment_button == "Error: El plazo de validez del enlace debe ser posterior a la fecha actual"

Con la salida del texto: "Lo sentimos, no llegó a tiempo y el enlace de pago ya no es válido":

Diálogo en la sección "Clientes"

Configuración del bloque "Condición inicial"

Variables del cliente que se crearán automáticamente al usar el botón con la función Pago

En cuanto el usuario reciba el bloque con el botón "Pago", se crearán automáticamente las variables del cliente:

Variable de servicio del cliente __payments , que almacena el importe y el identificador del enlace creado, y es necesaria para identificar el hook del sistema de pago.

¡La variable de servicio del cliente __payments NO SE PUEDE eliminar ni modificar!

Variable del cliente error_payment_button se crea si se produjo un error al generar el botón.

En el valor de la variable error_payment_button se registrará el texto del error o la respuesta del sistema de pago con error.

Los valores de las variables pasan a estar vigentes al pasar al siguiente bloque

Cómo procesar el resultado

Pago exitoso.

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

Por ejemplo: ovg58keefc_success 44, donde:

ovg58keefc : 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 (notificaciones) del sistema de pago. Solo se muestran en la pestaña Clientes y son visibles para el operador.

Ejemplo de uso: Paso 1. En el bloque "con botón Pago" añadimos botones con la función Pago.

Paso 2. En el campo Condición de conexión de este bloque con el bloque "Pago exitoso" indicamos el callback. Del mismo modo funciona si se indica el callback de pago exitoso en el campo Condición del bloque "Condición inicial".

Importante: seleccione la coincidencia Coincidencia exacta o Por presencia de palabras clave

❗️Si decide comprobar el pago precisamente en la flecha por condición, entonces piense bien la lógica de su esquema. En caso de que el cliente abandone el bloque con la transición por condición con callback, no habrá transición al bloque. Este método de comprobación solo tiene sentido usarlo cuando el cliente no cambia su posición en el embudo (posición en el esquema). En los esquemas en los que el cliente se desplaza por los bloques, es mejor usar la opción de indicar el callback en el bloque "Condición inicial".

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

Pago exitoso para productos con auto suscripción.

Después de un pago exitoso, al bot AUTOMÁTICAMENTE llegará un CALLBACK, que consta de los primeros 10 caracteres de la clave secreta del sistema de pago, la palabra _success y separado por un espacio, el ID del producto de suscripción

Por ejemplo: 214009eefc_success 618117, donde:

009eefc : 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 auto suscripción

Pago con error

Cuando ocurre un error al procesar el pago al bot AUTOMÁTICAMENTE llegará un CALLBACK, que consta de 10 caracteres de la clave secreta del sistema de pago, la palabra _fail y, separado por un espacio, el importe del pago

Por ejemplo, ovg58keefc_fail 44 , donde

ovg58keefc : 10 caracteres de la clave secreta del sistema de pago

_fail : resultado del procesamiento de la solicitud: el pago no se realizó o se produjo un error.

44 : importe del pago

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

Si el importe indicado en la configuración del botón difiere del importe que pagó el cliente, entonces AUTOMÁTICAMENTE llegará un CALLBACK, que consta de 10 caracteres de la clave secreta del sistema de pago, la palabra _different_amounts y, separado por un espacio, el ID único del pago

Por ejemplo: ovg58keefc_different_amounts 123456 , donde:

ovg58keefc : 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

Función get_prodamus_payment_url en la Calculadora

Para generar el enlace de pago puede utilizar la función get_prodamus_payment_url en el bloque Calculadora.

En el campo Calculadora, asignaremos a la variable el valor de la función get_prodamus_payment_url

Usted define el nombre de la variable por su cuenta. En las capturas de pantalla hay ejemplos de nombres de variables.

En esta variable se guardará el enlace de pago. La variable se puede mostrar en pantalla como enlace en un mensaje o colocar en un botón con el texto "Pagar".

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

Calculadora

Ejemplo 1:

Descripción de los parámetros

Ejemplo de código para copiar

Si en el bloque hay varias funciones para obtener el enlace y se produce un error, el valor del error se guardará en la variable error_payment_func

El error se registrará en la última función en la Calculadora

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

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

Para generar el enlace de pago, basta con establecer en el campo Calculadora el valor de la variable payment_sum. Inmediatamente después aparecerá la variable prodamus_pay_url.

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

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

Antes de declarar la variable payment_sum también se pueden indicar las siguientes variables opcionales:

Parámetros de la función	Descripción del parámetro
product_name	nombre del producto (si no se indica, se rellena con 'Pago de la factura order_id') - en la captura de pantalla de abajo se muestra dónde aparece
payment_description	descripción del producto (si no se indica, se rellena con 'Pago de la factura order_id', ver captura abajo) - en la captura de pantalla de abajo se muestra dónde aparece
discount_value	importe del descuento (por ejemplo discount_value = 25 o discount_value = 50.25)
customer_phone	número de teléfono del comprador, no es obligatorio si se ha pasado el parámetro
customer_email	email del comprador
link_expired	tiempo de vida del enlace de pago, en formato dd.mm.aaaa (por ejemplo 25.01.2021). También se puede en el campo "Calculadora" indicar: link_expired = current_date + 2 (el enlace será válido durante 2 días hasta las 00:00)
link_expired	también se puede indicar una fecha con hora exacta, separada por un espacio, en formato dd.mm.aaaa hh:mm (por ejemplo: 25.01.2021 12:23). También se pueden usar variables estándar, por ejemplo, definamos la duración 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 pasarse en minúsculas.
payment_title	título del pago (hasta 127 caracteres). Si no se indica, se rellena con el texto: “Pago de la factura payment_id” (payment_id - identificador del pedido en Salebot)
payment_description	descripción breve del pago (hasta 127 caracteres)
locale	idioma de la página de pago, se indica en forma de en-US, fr-XC, etc. Por defecto - ‘ru-Ru’. La lista completa está disponible en el enlace https://developer.paypal.com/api/rest/reference/locale-codes/
products_for_receipt	Cadena de 50 a 4000 caracteres en el formato "descripción del pedido - importe - enlace al recurso que se adquiere". Por ejemplo: “Curso ‘Pesca de brema’, precio 4999 rublos, enlace a la página del curso: https://www.lovilescha.ru/courses/poimai_kilogram/". Obligatorio, si no tiene su propia caja online, para la fiscalización de los pagos a través de Prodamus.
payment_sum	(obligatorio) importe del pago

Las variables discount_value, customer_phone, customer_email y link_expired también son válidas para las suscripciones.

Ejemplo de implementación.

En el primer bloque definimos el importe del pago:

Después mostramos en el lugar deseado la URL, el enlace prodamus_pay_url:

prodamus_available_payment_methods se declara antes de declarar payment_sum.

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 en EUR de todos los países, excepto РФ y РБ
SBP	Pago rápido, sin ingresar los datos de la tarjeta. Para tarjetas РФ
QW	Monedero Qiwi
PC	ЮMoney
GP	terminal de pago
sbol	Sberbank Online factura - Pago por factura cuotas - En cuotas de Prodamus
installment_5_21	En cuotas de Prodamus por 3 meses
installment_6_28	En cuotas de Prodamus por 6 meses
installment_10_28	En cuotas de Prodamus por 10 meses
installment_12_28	En cuotas de Prodamus por 12 meses installment_0_0_3 - Pago a plazos de Tinkoff por 3 meses
installment_0_0_4	Pago a plazos de Tinkoff por 4 meses
installment_0_0_6	Pago a plazos de Tinkoff por 6 meses
installment_0_0_10	Pago a plazos de Tinkoff por 10 meses
installment_0_0_12	Pago a plazos de Tinkoff por 12 meses
installment_0_0_24	Pago a plazos de Tinkoff por 24 meses
installment_0_0_36	Pago a plazos de Tinkoff por 36 meses
crédito	Crédito de Tinkoff
vsegdada_installment_0_0_4	Pago a plazos de VsegdaDa por 4 meses (no funciona con available_payment_methods)
vsegdada_installment_0_0_6	Pago a plazos de VsegdaDa por 6 meses
vsegdada_installment_0_0_10	Pago a plazos de VsegdaDa por 10 meses
vsegdada_installment_0_0_12	Pago a plazos de VsegdaDa por 12 meses sin sobrepago
vsegdada_installment_0_0_24	Pago a plazos de VsegdaDa por 24 meses
vsegdada_installment_0_0_36	Pago a plazos de VsegdaDa por 36 meses
sbrf_installment_0_0_6	Pago a plazos de SberBank por 6 meses
sbrf_installment_0_0_10	Pago a plazos de SberBank por 10 meses
sbrf_installment_0_0_12	Pago a plazos de SberBank por 12 meses
sbrf_installment_0_0_24	Pago a plazos de SberBank por 24 meses
sbrf_installment_0_0_36	Pago a plazos de SberBank por 36 meses
otp_installment_0_0_6	Pago a plazos del Banco OTP por 6 meses
otp_installment_0_0_10	Pago a plazos del Banco OTP por 10 meses
otp_installment_0_0_12	Pago a plazos del Banco OTP por 12 meses
otp_installment_0_0_24	Pago a plazos del Banco OTP por 24 meses
otp_installment_0_0_36	Pago a plazos del Banco OTP por 36 meses
mts_installment_0_0_6	Pago a plazos del Banco MTS por 6 meses
mts_installment_0_0_10	Pago a plazos del Banco MTS por 10 meses
mts_installment_0_0_12	Pago a plazos del Banco MTS por 12 meses
mts_installment_0_0_24	Pago a plazos del Banco MTS por 24 meses
mts_installment_0_0_36	Pago a plazos del Banco MTS por 36 meses
monetaworld	Tarjetas de bancos de todo el mundo, excepto РФ
sbrf_bnpl	En cuotas de Sber

Se permite pasar varios valores, separándolos con una barra vertical. Por ejemplo: prodamus_available_payment_methods = "AC|PC|QW"

prodamus_currency - otro parámetro adicional para pasar el importe en una moneda determinada. Valores posibles de la moneda: kzt - para el tenge eur - para el euro usd - para el dólar

Entonces el importe indicado en el enlace estará en la moneda especificada.

Al recibir el callback payment_callback hay que guiarse por el parámetro currency y currency_sum, en los que habrá la moneda y el importe en esa moneda.

¡Importante! Comprueba si en tu página está disponible el método de pago en la moneda necesaria, ya que si no está, se pasará a una página sin métodos de pago. Los métodos se conectan a través del soporte. Los habilitados pueden verse en la configuración de la página o generando un enlace de pago

Configuración de la página de pago del sistema de pago "Prodamus"

Opciones de pago que están conectadas para tu página

Cómo procesar el resultado

Pago exitoso

¡Importante! Después de un pago exitoso o fallido, llegarán al bot callbacks con los que podrás entender que hubo un pago exitoso. Estos callbacks en el sistema los ves como mensajes del usuario; para que el usuario no pueda enviarlos, consisten en una clave secreta y un sufijo con el estado, por ejemplo: 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success o 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_fail. Además, después de un pago exitoso la variable prodamus_payment_completed se establece en True.

¡Atención! Los callbacks llegan con retraso, así que después de mostrar el enlace de pago al usuario recomendamos enviar un mensaje como: “Después del pago, espera el mensaje de finalización exitosa del pago”

¡IMPORTANTE! Para los enlaces creados con el botón con la función Pago o con la función del Calculador, después del pago al bot AUTOMÁTICAMENTE llegará un CALLBACK, que consta de los caracteres de la clave secreta del sistema de pago, la palabra _success y, separados por un espacio, el importe del pago. Para usarlo en la configuración del esquema basta con copiarlo.

Por ejemplo: ovg58keefc_success, donde:

ovg58keefc : clave secreta completo

_success : resultado del procesamiento de la solicitud (pago exitoso)

Por ejemplo, se puede hacer el procesamiento del pago exitoso con un bloque condicional y mostrar el mensaje correspondiente al usuario:

El tipo de comparación debe ser "Coincidencia exacta"

Para realizar un pago repetido, es obligatorio poner payment_sum a cero, la URL ya generada y después reasignar la variable payment_sum para obtener una URL nueva

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

También en Prodamus existen notificaciones sobre la activación/desactivación de la suscripción:

1. "El suscriptor desactivó la suscripción" - si la suscripción se cancela manualmente (por ejemplo, rechazó la suscripción).

Puede llegar antes de que termine el período pagado actual. Implica una acción a tu criterio: ignorarlo o ponerlo bajo control, intentar recuperar al suscriptor.

1. "El suscriptor reactivó la suscripción" - restauración de la suscripción.

Puede llegar si el suscriptor reactivó la suscripción antes de que termine el período pagado actual. Implica una acción a tu criterio: ignorarlo o eliminarlo de la lista de seguimiento para su recuperación.

1. "Desactivación de la suscripción" - si la suscripción se desactiva después de varios cargos fallidos

Cómo guardar los valores del callback

Después de recibir la notificación de pago exitoso, en la solicitud del cliente (variable payment_callback) se escribirá el callback de Prodamus, con todos los datos del pago recibido. De él puedes guardar los datos necesarios y usarlos como prefieras. 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": "Aquí descripción del producto", "payment_type": "Tarjeta de plástico Visa, MasterCard, MIR", "commission": "3.5", "commission_sum": "0.51", "attempt": "1", "discount_value": "10.5", "products[0][name]": "Acceso a los 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 generar el enlace puedes indicar variables product_name y payment_description. Entonces al recibir el callback se podrán obtener así

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

description = get(payment_callback,'customer_extra')

Atención: a la variable payment_sum se le asigna el valor de la última, después de las variables opcionales payment_description, product_name

El importe se puede obtener así summa = get(payment_callback,'sum')

Qué callbacks están disponibles

Además de los callbacks principales sobre el pago exitoso, en el chat con el usuario se muestra un mensaje que el usuario no ve, con los siguientes textos:

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

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

3. La suscripción ha finalizado

4. Pago no exitoso - sufijo con la explicación (en la captura de pantalla de arriba)

5. Aviso de próximo cargo - fecha y hora del próximo cargo

6. Solicitud de cuotas 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 ha superado el límite de la tarjeta.

• Pago no exitoso - Tarjeta perdida

• Pago no exitoso - Error del sistema

• Pago no exitoso - Operación denegada. Contacte 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.

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

• Solicitud de cuotas aprobada

• Solicitud de cuotas cancelada

• Solicitud de cuotas rechazada

Puedes leer más sobre la descripción de los errores aquí:

Коды ошибокhelp.prodamus.ru

Prodamus: códigos de error

Opcionalmente, se puede configurar el envío de algún mensaje al usuario. Por ejemplo, enviaremos un mensaje de que el cargo automático no se pudo realizar. En la notificación sobre pago no exitoso con una causa específica, se puede configurar un bloque con respuesta, por ejemplo, así:

ejemplo de bloque para notificaciones de Pago no exitoso con causa específica

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

ejemplo de bloque para notificaciones de Pago no exitoso con cualquier explicación del motivo

Y en todos los callbacks en los que aparezca el texto Pago no exitoso, el usuario recibirá un mensaje con el texto que hayas indicado.

Cómo crear pagos por suscripción

Cómo crear una suscripción

Para crear una suscripción, hay que crear un producto de suscripción. Instrucciones detalladas de cómo hacerlo: https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski

Después copiamos el id del producto de suscripción; abajo se muestra de dónde obtenerlo:

Creación de producto de suscripción

Para generar el enlace de pago de la suscripción, debes establecer el valor (id del producto de suscripción) de la variable prodamus_subscription, inmediatamente después de eso aparecerá la variable prodamus_pay_url.

La variable prodamus_pay_url se puede mostrar en pantalla mediante un enlace o colocarla en un botón con el texto "Pagar". El enlace tiene el siguiente aspecto: https://payform.ru/7p3JR8/

El procesamiento del resultado ocurre igual que en un pago único (leer arriba).

Después de una suscripción exitosa, al usuario se le añadirá la variable con el número de teléfono introducido al pagar customer_phone. El número de teléfono se necesita para gestionar la suscripción.

customer_phone se necesita para gestionar la suscripción, si no se ha proporcionado customer_email

Cómo crear un enlace de suscripción con la función get_prodamus_subscription_url

Veamos otra forma de generar el enlace de pago de un producto por suscripción.

Creamos un producto de suscripción en el panel de Prodamus. Instrucciones detalladas de cómo hacerlo: https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski

Después copiamos el id del producto de suscripción; abajo se muestra de dónde obtenerlo:

Creación de producto de suscripción

Para obtener el enlace de pago del 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 de un producto por suscripción

Descripción de los parámetros

Ejemplo de código para copiar

Si en el bloque hay varias funciones para obtener el enlace y se produce un error, el valor del error se guardará en la variable error_payment_func

El error se registrará en la última función en la Calculadora

Cómo gestionar el estado de la suscripción

El método funciona solo con suscripciones reales; en modo demo no hay enlace con la tarjeta

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

Para permitir que el usuario cancele la suscripción, hay que crear un bloque y llamar a la función: https://store.salebot.pro/function/delete_subscription_prodamus

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 indicada en la configuración del constructor secret_key - clave secreta de la configuración id_subscription - id del producto de suscripción customer_phone - teléfono del suscriptor switcher = 0 es la detención de la suscripción; si se pasa 1, la suscripción se reactiva. profile_id - ID del perfil en el sistema Prodamus

¡Atención!

Si llega el id del perfil, su valor se guardará en la variable profile_id.

profile_id se puede pasar a la función delete_subscription_prodamus en lugar de customer_phone o customer_email para cancelar la suscripción.

Ejemplo de configuración del bloque de suscripción:

Tenga en cuenta que la función devuelve status, que guardamos y podemos procesar a nuestra discreción, al desactivar/activar con éxito status es ok

Función para gestionar la suscripción

prodamus_subscription_switch_status(subscription_id, switcher, customer_phone, customer_email, profile_id)

id_subscription - id del producto de suscripción

switcher = 0 es la detención de la suscripción; si se pasa 1, la suscripción se reactiva.

customer_phone - teléfono del suscriptor - opcional, si se pasa customer_email

customer_email - correo electrónico del suscriptor - opcional, si se pasa customer_phone

profile_id - ID del perfil en el sistema Prodamus

Ejemplo de uso de la función prodamus_subscription_switch_status

Ejemplo: se ha pasado el parámetro customer_phone, se ha omitido customer_email stat = prodamus_subscription_switch_status('618117', '0', '75431312321')

Ejemplo 2: se ha pasado el parámetro customer_email, se ha omitido customer_phone stat = prodamus_subscription_switch_status('618117', '0', '', '[e-mail]')

La función devolverá ok si todo ha ido correctamente o la descripción del error

Gestión de descuentos en la suscripción

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

prodamus_subscription_discount(subscription_id, discount, customer_phone, num, profile_id) donde: subscription_id - ID de la suscripción discount - número decimal con precisión de hasta dos dígitos después de el punto, el valor debe ser mayor que cero y no exceder el coste base de la suscripción customer_phone - número de teléfono del cliente en formato: [phone] (parámetro opcional, si existe la variable customer_email (aparece después del primer pago, ver descripción arriba)) num - Cantidad de pagos durante los que se aplicará el descuento (parámetro opcional; si no se pasa, la cantidad de pagos con descuento no está limitada)

profile_id - ID del perfil en el sistema Prodamus Si la solicitud se ejecuta correctamente, la función devolverá 'ok'; si la solicitud se ejecuta con error, la función devolverá su descripción.

¡El importe del descuento y el intervalo se sobrescriben SOLO si la función se llama de nuevo con nuevos valores!

Ejemplos:

1. Configuración de un descuento de 1 rublo para todos los siguientes pagos automáticos (el número de teléfono no se indica, ya que se tomará automáticamente de la variable customer_phone, y la cantidad de cobros con descuento por defecto es para todo el período de la suscripción)

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

Ejemplo 1

2. Configuración de un descuento de 2 rublos para los siguientes 3 cobros (el número de teléfono se sustituye por comillas vacías, ya que se tomará automáticamente de la variable customer_phone)

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

Ejemplo 2

3. Ejemplo de configuración de un descuento en forma de número con parte decimal hasta centésimas (separador punto), los datos numéricos se indican sin comillas, el número de teléfono se pasa mediante la variable

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

Ejemplo 3

Cómo establecer la fecha del siguiente pago de la suscripción

Con este método se puede mover la fecha del siguiente pago de la suscripción. La fecha solo se puede mover "hacia el futuro" con respecto a la fecha actual establecida del siguiente pago. Así se aumenta el tiempo de permanencia en el club.

Por ejemplo, se puede usar como bono para los suscriptores.

Para ello hay que usar la función:

prodamus_subscription_payment_date(subscription_id, date, customer_phone, profile_id)

donde:

subscription_id - id de la suscripción date - fecha en formato dd.mm.aaaa hh:mm o dd.mm.aaaa; entonces la hora será 00:00 customer_phone - no es obligatorio; si no se pasa, se tomará de la variable customer_phone; si tampoco se encuentra ahí, no funcionará profile_id - ID del perfil en el sistema Prodamus

Cómo pasar parámetros a Prodamus

Para pasar a Prodamus los parámetros que necesites (por ejemplo, fecha de inicio de la suscripción, desactivación del pago a plazos, etc.), añade prodamus_ al principio del nombre de la variable

Entonces, al generar el enlace de pago, estos parámetros se pasarán automáticamente al sistema de pago.

Cómo probar el pago

¡Solo probamos el pago!

Para que no se carguen fondos de tu cuenta al probar la integración y la configuración de los embudos de pago, puedes usar tarjetas de prueba

Primero cambia tu página de pago al modo DEMO ⤵

No olvides pulsar el botón "Guardar"

Para realizar un pago de prueba puedes 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 669

MasterCard Número de tarjeta 5469 9801 0004 8525 Fecha de caducidad 05/26 Código de verificación en el reverso 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 941 Código de verificación 3-D Secure 111111

¡Al pagar con cuentas de prueba, todos los embudos e integraciones configurados funcionarán como en un pago normal!

Formulario probado

Para recibir pagos con dinero real, es necesario poner el formulario en modo operativo. Es decir, mover el control deslizante de cambio del modo demo a la posición para que se vuelva rojo pálido