Set up Nimiq PayNimBot in Telegram

Wekkel Ekkel
5 min readOct 23, 2018

This tutorial guides you through setting up the PayNimBot in Telegram. The tutorial is based on Android 8.0.0 and Telegram 4.9.1.

What is Nimiq?

First, a short overview of Nimiq.

New Nimiq Logo

Nimiq (NIM) is a cryptocurrency operating completely within a browser. You can go to the website, click the ‘Safe’ button, and walk through the steps to create your first Nimiq wallet and start receiving Nimiq tokens (NIM).

All this without installing anything.

With this feature, it is truly one of a kind (some other but allegedly inferior alternatives exist). This essentially ensures an extremely low adoption barrier, especially if it is integrated in existing popular apps such as Telegram.

Head over to the Nimiq website if you want to learn more:

https://www.nimiq.com/en/

https://www.nimiq.com/en/#faq

Telegram

Telegram (TG) is a widely used messenger app. It is a big competitor of Whatsapp. With the ability of users writing programs for TG, so called ‘bots’ and easy web accessibility and installation on multiple devices without hassle, TG has become the de facto standard messaging channel in Western countries for many crypto currency projects.

PayNimBot in Telegram

You can pay with NIM in TG now. This is done by adding the @PayNimBot to your list of channels. Below, I walk through the steps of:

  1. setting up the bot
  2. setting up a payment in TG
  3. completing the payment via the Nimiq web wallet

The screenshots below have been edited with black for privacy reasons.

Setup

Step 1:

Telegram: official Nimiq TG group with someone posting the name of the PayNimBot

In TG, seach the @PayNimBot and add to your list. In the shown case, I tapped the name of the bot in the official Nimiq TG channel.

Step 2:

Telegram: opening message. Your message will differ.

The bot channel opens. In the shown case, the bot was added already but for the purposes of the tutorial removed from the list and re-added. There should be a button below with ‘start’ or something similar. In the show case it shows ‘Herstart’ (restart).

Tap that button and proceed.

Step 3:

Telegram: opening message. Your opening message will differ

The bot in the shown case already has a wallet linked to it. So your starting message will be different. You need to attach a Nimiq wallet to the bot (as the bot will explain). For the purposes of this tutorial, these steps are shown below. Of course, use your own Nimiq wallet address.

Note: it is important that the Nimiq wallet address is the same as the Nimiq wallet address used on the particular device. Do not use a Nimiq wallet address generated and existing on another device. If necessary, create a wallet on the device that also runs your TG app via the Nimiq website.

Telegram: giving the command to attach a Nimiq wallet address to the TG bot
Telegram: attaching the wallet proved successful. You are all set up! Click /help if you need more information

If you need help, just give the /help command.

Making a NIM payment with TG

Making a payment basically works as follows:

  1. in the relevant TG channel, type ‘@PayNimBot’ followed by an amount and a popup appears
  2. click the popup and your payment offer goes is placed in the TG channel. Please note that anyone can click the ensuing button (except yourself) and claim the payment. If you want to pay a specific person, make sure to open an individual channel with that person first
  3. once the payment has been accepted by the counter party, the PayNimBot acknowledges this in its own channel with a link to complete the payment via the Nimiq website (from the Nimiq wallet in the browser of your device)
  4. tapping the link will bring you to your Nimiq wallet, automatically opening a payment order that you can subsequently submit
  5. after submitting the payment (confirming the payment in the second final confirmation page), the NIM payment is done. The PayNimBot will confirm that the payment was made as well

In pictures:

Step 1: offering the payment in the TG channel

Telegram: typing the bot name with an amount to pay automatically triggers a pop up. Click the pop up
Telegram: someone clicked the payment offer in the channel. I have to go to the PayNimBot channel now to complete the payment

Step 2: completing the payment

Telegram: a message with a link appears in the PayNimBot channel. Click the link
Telegram: the pop up tells you that you will be redirected to the Nimiq website. Click to open the link
NImiq: the Nimiq Safe (the wallet) opens with a payment order confirming all details. Wait for Nimiq blockchain to synchronise with your device
Telegram: device is synchronised now. Make the payment by clicking ‘ Send’
NImiq: final confirmation page with a password check. Click ‘confirm’ to confirm the payment
Nimiq: the payment appears in the list of recent transactions
Telegram: back in the TG PayNImBot channel the payment is confirmed as well

--

--