Balance notifications via Telegram: configuring the MONA Pay bot

The MONA Pay Telegram channel posts one message to your Telegram group every time your ACB account (or a selected VA) receives money, with no code at all. Setup in the dashboard under Telegram takes 3 actions: add the MONA Pay bot to the group, paste the group’s group_id (plus topic_id if the group uses topics), and click “Send test” to see the first message. The template is editable with variables such as {{amount}} and {{transaction_content}}. Accountants, shop owners and delivery staff all see the money arrive at the same time, instead of one person watching a banking app and relaying it to everyone.

Dashboard setup (no code)

1. Create a Telegram group (or use your company’s existing one). Add the MONA Pay bot with permission to send messages; the bot’s name is shown in the dashboard under Telegram.
2. Get the group_id: open the group on web.telegram.org; the group ID is the number in the address (groups usually start with a minus sign, e.g. -1001234567890), or use any ID bot. If the group has Topics enabled, also take the topic_id (the number at the end of the topic’s link) so messages land in the right topic.
3. Create the configuration in the dashboard: give it a name, paste the group_id (+ topic_id), choose all accounts or a single VA, keep the default template or edit it.
4. Send a test: the “Send test” button has 2 modes, a connection-check message and a simulated transaction rendered with your template. Seeing the message in the group means you are done.

One account can have many configurations: the accounting group receives every transaction, the sales group only the VA of that store.

Message template

Default template (Telegram renders <b> as bold):

💰 <b>Biến động số dư</b>

Tên ngân hàng: {{bank_name}}
STK: {{account_number}}
Loại giao dịch: tiền {{vao_hay_ra}}
Số tiền: {{cong_hay_tru}}{{amount}}đ
Thời gian: {{transaction_date}}
Nội dung: {{transaction_content}}

A compact template for a sales group:

✅ +{{amount}}đ vào {{account_number}}
{{transaction_content}} · {{transaction_date}}

API /api/v1/telegram-configs

Every request needs Authorization: Bearer; POST/PUT/DELETE also need X-Client-Secret (see Authentication).

Fields on create:

cURL: create a configuration

curl -X POST https://api.monapay.vn/api/v1/telegram-configs \
  -H "Authorization: Bearer $MONA_TOKEN" -H "X-Client-Secret: $MONA_SECRET" \
  -H 'Content-Type: application/json' \
  -d '{"group_id":"-1001234567890","friendly_name":"Accounting group","message_template":"✅ +{{amount}}đ vào {{account_number}}\n{{transaction_content}} · {{transaction_date}}"}'

cURL: send a simulated transaction

curl -X POST https://api.monapay.vn/api/v1/telegram-configs/test \
  -H "Authorization: Bearer $MONA_TOKEN" -H "X-Client-Secret: $MONA_SECRET" \
  -H 'Content-Type: application/json' \
  -d '{"group_id":"-1001234567890","is_dummy":true}'

is_dummy: false sends a “connected” message to confirm the bot is in the group; true sends a fake transaction rendered with message_template (the default template if omitted).

PHP

<?php
$body = [
    'group_id' => '-1001234567890',
    'friendly_name' => 'Accounting group',
    'message_template' => "✅ +{{amount}}đ vào {{account_number}}\n{{transaction_content}} · {{transaction_date}}",
];
$ch = curl_init('https://api.monapay.vn/api/v1/telegram-configs');
curl_setopt_array($ch, [
    CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: Bearer ' . getenv('MONA_TOKEN'), 'X-Client-Secret: ' . getenv('MONA_SECRET')],
    CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE),
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
if (empty($res['success'])) throw new RuntimeException($res['message'] ?? 'Failed to create Telegram configuration');

Node

const r = await fetch('https://api.monapay.vn/api/v1/telegram-configs', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${process.env.MONA_TOKEN}`, 'X-Client-Secret': process.env.MONA_SECRET },
  body: JSON.stringify({
    group_id: '-1001234567890',
    friendly_name: 'Accounting group',
    message_template: '✅ +{{amount}}đ vào {{account_number}}\n{{transaction_content}} · {{transaction_date}}',
  }),
});
const { success, message } = await r.json();
if (!success) throw new Error(message);

Resending a transaction

If a message did not arrive (the group ID changed, the bot was kicked and re-added), resend from the dashboard under Transactions, or call POST /api/v1/acb/virtual-account/transactions/{transaction_id}/retry with {"target_type":"TELEGRAM"} (see Transactions).

Common problems