Agents Telegram Payouts / DONE

Instructions for setting up Telegram Agents payments

Description

The module allows you to set up currency payouts through operators who will receive messages with possible requests in a separate telegram group. The group will be able to see the details of the request, assign to them and change their status after successful/unsuccessful payment.

The administrator will be able to monitor in the group the status of the request, operators, as well as the time spent on the payment.

Installation

Using the parameters below, install the module via the ‘Installplugin’ functionality according to the instructions: Install plugin / DONE.

Install Plugin Parameters

Plugin type: Payout module

Plugin URL: @boxexchanger-plugins/payout-agents-telegram

Directory path: agents-telegram

Auth: (Deploy token): leave blank

Package tag: latest

Configuration

1. Create a new group in Telegram and add the bot https://t.me/payout_agents_bot to it.

2. In the chat of the created group, send the command /start@payout_agents_botto generate API URL and keys -> save the values of API URL, API Key, Secret Key to a safe place -> delete the message from the chat for security reasons.

To regenerate keys you can use the command

/regenerate@payout_agents_bot

The commands /start@payout_agents_bot and /regenerate@payout_agents_bot can be called by any member of the group, but the bot will send API URL, API Key, Secret Key or regenerate keys only if the above commands are called by the group administrator.

1. Go to the admin panel of the script -> ‘Merchant and API’ page - ‘PAYOUT SYSTEM’ section -> click on the settings icon in the block with the ‘Payout Agents’ module.

2. On the module settings page specify API URL, API Key, Secret Key values in the corresponding fields -> click ‘Save’ next to each field.

3. For ‘Send route fields (from order)’ select the appropriate parameter according to the table below -> click ‘Save’.

Yes	No
If ‘Yes’ is set, both data from the output currency fields and data from the destination fields will be displayed in the request details message.	If the parameter ‘No’ is set, only data from the payment currency fields will be displayed in the message with request details.

1. In the currency/destination settings, set ‘Payout Agents’ as the payout module.

Please note, one group in Telegram = one payout module ‘Payout Agents’. In case you need to separate payments of different currencies into groups, for example, ‘PayoutUAH’, ‘PayoutUSD’, etc., you can duplicate this payout module via Install plugin / DONE, functionality, while specifying a unique ‘Directory path’ for each subsequent module. Also note that for each new module you need to specify a unique API URL, API Key, Secret Key, which can be obtained in a new created Telegram group according to the instructions above.

Interaction with the application

1. In the previously created Telegram group add operators who will process requests.

2. Wait until the bot sends a message to the group with details of the request. An example of such a message is on the screenshot

Note that the bot sends a new request to the chat a few seconds after the request has been set to#na-vyplatu status (i.e. the ‘Payout Agents’ module for OUT currency has been started).

Until the application has been accepted by one of the operators - data from the application fields will be partially hidden for all group members.

1. As soon as one of the operators is ready to process the request -> the operator should press the ‘Accept’ button in the message with the required request. After clicking on the button the operator will be assigned to the request and all group members will see the data from the fields of the request. The example is on the screenshot.

2. After the operator is assigned to the request, it becomes possible to mark the payment as completed (the ‘Done’ button) or to disassociate from the request (the ‘Cancel’ button). More details about each button in the table below.

Done	Cancel
When you click on the ‘Done’ button, the status of the request changes to zavershena, and a line with the time of completion of processing the request is added to the message from the bot. Example on the screenshot..	When you click on the ‘Cancel’ button, the request status changes to oshibka-pri-vyplate, and a line with the time when the operator cancelled the request is added to the message from the bot. Example on the screenshot.

The request, for which the status oshibka-pri-vyplate was set (after clicking on the ‘Cancel’ button), can be sent to the bot again to be processed by another operator. To do this, just in the admin panel of the script, in the details of the request, change its status to na-vyplatu. More information about changing the request status in the izmenenie-statusa instruction.

The ‘Done’ and ‘Cancel’ buttons will be displayed for all members of the group, but changing of the request status by pressing one of the buttons will happen only if such action is performed by the operator assigned to the request. Otherwise, an error will be displayed, which informs that the request is assigned to another operator.

Structure of application details

• It is possible to copy the values of the order number, data from the fields, as well as the amount by clicking on such value. Example on the

• If the operator has username set in Telegram, then after pressing the ‘Accept’ button, the username of the operator who accepted the request will be set in the ‘Accepted By’ field. Example on the

• If the operator does not have username in Telegram, then after clicking on the ‘Accept’ button, the name and surname of the operator who accepted the request will be set in the ‘AcceptedBy’ field. Example on the

• In the ‘Currency’ field the XML of the withdrawal currency and the type of withdrawal currency are displayed. Example on the