Telegram

Cómo conectar el sistema de pago

El sistema de pago está integrado en Telegram.

Para realizar pagos dentro del mensajero, necesitas:

• conectar el sistema de pago al bot en el botfather bot

• ir a la configuración del bot deseado y en el menú seleccionar Payments

• seguir las instrucciones para conectar un sistema de pago disponible y copiar el token emitido

Cómo facturar a un cliente

Para enviar una factura a Telegram usa el método

tg_send_invoice(provider_token, platform_id, title, description, currency, prices, photo_url, payload, protect_content, disable_notification, need_name, phone_number, need_email, reply_to_message_id, reply_markup, reply_id) - los parámetros requeridos están resaltados en negrita

provider_token - token recibido en Botfather, después de conectar el sistema de pago

platform_id - destinatario - identificador de usuario, grupo o canal

title - título del artículo, 1-32 caracteres

description - descripción de los productos, 1-255 caracteres

currency - moneda de pago (RUB, USD, UAH y así sucesivamente https://core.telegram.org/bots/payments#supported-currencies)

payload - la primera parte de la moneda sobre el pago, por defecto tg_payment

prices - desglose del precio (descripción abajo)

photo_url - enlace a la imagen del producto

disable_notification - 1 - enviar con notificación, 0 - sin notificación

protect_content - 1 protección contra copias y capturas de pantalla, 0 - sin protección

need_name - 1 si necesitas un nombre completo para completar el pedido, 0 - sin pedir un nombre

need_phone_number - 1 si requieres el número de teléfono del usuario para completar el pedido, 0 - sin solicitar número

need_email - 1 si requieres la dirección de correo electrónico del usuario para completar el pedido, 0 - sin solicitar correo

reply_to_message_id - el id del mensaje al que respondemos, '' no es la respuesta

reply_markup - teclado, el primer botón debe ser un botón con tipo de pago

Si se especifica uno de los parámetros need_name, need_phone_number o need_email, el usuario solicitará los datos antes de pagar y los guardará en las variables del cliente si el pago se realiza correctamente. En la captura de pantalla de abajo se muestra la solicitud de todos los datos de entrada:

prices - un array de arrays con datos sobre el costo de los productos y servicios adicionales (entrega, embalaje, etc.). Se muestra en la página de pago. El importe deberá indicarse ya sea con un entero de 125 o con un decimal mediante punto 120.25 Por ejemplo: [["productos", 2000], ["IVA", 20.75], ["embalaje", 100]

Callback del pago

Después de un pago exitoso, en el chat con el usuario llegará un colbeck de la siguiente manera:

phone_best 4737685 2120.75 UAH 1955518436

donde phone_best - payload - de la solicitud de creación de la factura 473737685 - un id de chat, al que originalmente se envió la factura 2120.75 - el importe total del pago UAH - moneda 1955518436 - id de pago en el sistema del comerciante

Además, si solicitaste un nombre, teléfono y/o correo electrónico, el cliente escribirá las variables:

tg_payment_name, tg_payment_phone y tg_payment_email

En caso de éxito, el kolbek se enviará a los mensajes personales del usuario. Para ello, el cliente y el bot deben cooperar antes del pago (¡el cliente debe estar suscrito al bot)!

Después de recibir el hook sobre el pago, el pago se confirmará automáticamente mediante answerPreCheckoutQuery https://core.telegram.org/bots/api#answerprecheckoutquery .

Ejemplos

prices = [["product", 2000], ["NDS", 20.75], ["package", 100]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'phoneW-200', 'El mejor modelo del mercado', 'UAH', prices, 'https://images11.popmeh.ru/cropped.jpg', 'phone_best', 0, 0, 1, 0, 1)

Ejemplo con conjuntos mínimos de parámetros

prices = [["un producto asombroso", 20000]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, '¡El mejor bot de todos!', '¡Un curso increíble! ¡Sé el mejor!', 'UAH', prices)

Ejemplo con un teclado

prices = [["product", 2000], ["NDS", 20.75], ["package", 100]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Phone W-200', 'Mejor modelo del mercado', 'UAH', prices, 'https://helpix.ru/news/200405/181746/gf200_2.jpg', 'phone_best', 0, 0, 1, 1, 1, '', '{"inline_keyboard": [[{"text":"Pagar", "pay":"True"}], [{"text":"Otro botón más", "callback_data": "Otro botón más"}]]}')