T-Bank acquiring notifications in Telegram: a message for every paid order

T-Bank (formerly Tinkoff) acquiring notifications reach Telegram in nana800 like this: the bank sends the payment status to the address of the webhook trigger, the webhook response block answers OK, and Telegram message send tells you about the paid order. You need your own acquiring terminal and a bot from @BotFather, with no code and no server. A payment message takes two basic block runs.

Build it in the builder

What you can automate

  • A message for every paid order: the status CONFIRMED, the order number OrderId, the amount and the masked card number Pan
  • With two-step payments, hear about the status AUTHORIZED: the money is held on the card, so it is time to confirm or cancel the order
  • Get notifications about payments created by the T-Bank Acquiring block without touching the terminal settings: the webhook address goes into the payment notification URL field
  • Show the amount in rubles right away: get_payment_state of the T-Bank Acquiring block returns amount_rub and confirms the payment at the same time
  • Send payments of several shops to different chats: every terminal has its own TerminalKey in the notification

How to set it up

  1. 1

    Create a scheme and the answer for the bank

    Create a scheme with the webhook trigger, the POST method and a path such as /tbank-pay. Right after it add the free webhook response block: put OK in capital Latin letters into body raw and keep the status OK. T-Bank does not wait long for the answer, 10 seconds for one-step payments, so the answer goes first.

  2. 2

    Give the webhook address to T-Bank

    Turn the scheme on and copy the webhook address on the API page. For website payments, enter it as the notification address in the terminal settings of your T-Bank account. Payments created by the T-Bank Acquiring block only need the payment notification URL field: the address sent with the new payment wins over the one in the settings.

  3. 3

    Keep only the message about the payment

    T-Bank sends several notifications about one payment, for example AUTHORIZED and then CONFIRMED. Put the free condition block after the answer: Status equals CONFIRMED. The bank gets OK for every notification, and Telegram gets one message when the money is taken.

  4. 4

    Write the message text

    Connect Telegram message send with the bot token and chat ID to the branch where the condition is true. The notification body holds OrderId for the order number, PaymentId for the T-Bank payment number, Amount in kopecks (150000 means one and a half thousand rubles) and Pan for the masked card. The plain_text format does not break on any characters.

  5. 5

    Add a payment check and the amount in rubles

    Between condition and Telegram you can add the T-Bank Acquiring block with get_payment_state and the PaymentId from the notification. It returns amount_rub, the amount in rubles, and is_paid, which is true only for a real payment: check it with a second condition before sending. That is two more runs, and an enabled scheme costs $0.0042 per hour.

Pricing

A run of a T-Bank acquiring block costs $0.002, a run of a Telegram block costs $0.001. Every month the balance is topped up to $3.50 for free, an enabled scheme costs $0.0042 per hour.

Services in this connection

  • T-Bank acquiring

    T-Bank internet acquiring without code: payment links, payment checks, captures and refunds right from a scheme. Free balance every month, no card needed.

  • Telegram

    Build a Telegram bot without code: reply to messages, add buttons, send leads and alerts to a chat, group or channel. Free balance every month, no card needed.

Similar integrations

  • amoCRM + Telegram

    Get new amoCRM deals and stage changes as Telegram messages in a private chat or a team group. No code and no server, free balance every month.

  • Bitrix24 + Telegram

    Get new Bitrix24 leads, deals and tasks as Telegram messages in a private chat or a team group. No code and no server, free balance every month.

  • CloudPayments + Telegram

    CloudPayments reports a payment, a decline or a refund, and the bot posts the amount, order number and decline reason to Telegram. No code, free balance monthly.

  • Email + Telegram

    Forward new emails from any IMAP mailbox to Telegram with no code: sender, subject and text, also from your company domain. Free balance every month, no card needed.

  • Gmail + Telegram

    Get new Gmail emails as Telegram messages: sender, subject and text in your private chat or a team group. Free balance every month, no card needed.

  • HTTP request + Telegram

    Check a website or API on schedule and get a Telegram message when it is down or returns an error. No code and no server of your own, free start every month.

Frequently asked questions

A paid order is one webhook run and one message, two basic block runs, and 1,000 runs cost $1. A notification with another status and no message costs one run, because the OK answer and condition are free. The get_payment_state check adds two runs. The scheme stays on all the time, and its hours take most of the free $3.50 a month.

The bank treats the notification as undelivered and repeats it every hour for a day, then once a day for a month. This happens when the scheme is off and the webhook answers with code 409. Without a webhook response block nana800 answers with code 200 but with {"finished":true,"default":true} instead of OK, so the repeats start as well.

No. Token is a SHA-256 signature made from the notification fields and the terminal password, and nana800 has no block that computes SHA-256. So anyone who knows the webhook address can fake a notification. Before releasing goods, confirm the payment with the T-Bank Acquiring block and get_payment_state: a real payment has is_paid equal to true.

Do not replace it, or the website stops seeing payments. Payments created in nana800 get their own address through the payment notification URL field, which wins over the terminal settings. If you also want messages about website payments, ask your developer to forward every notification to the nana800 webhook address as well.

On the API page open the Try it tab and send JSON like {"Status": "CONFIRMED", "OrderId": "test-1", "PaymentId": "1", "Amount": 150000}. The message arrives in Telegram, and the run history shows the OK answer. If the scheme has the get_payment_state check, it returns an error for a made-up payment number, which is expected.

Build your first scheme for free

Sign-up is free and needs no card. Every month the balance is topped up to $3.50 for free, enough for about 3,500 runs of basic blocks.

Build it in the builder