GlobalPay Merchant Docs for Telegram Payments

This document assumes that:

you carefully studied Telegram Bot Payments API;
you know how to create a payment invoice;
your bot replies to pre_checkout_query

Testing Integration

To test your payment integration with GlobalPay:

Obtain a provider_token from BotFather. See Appendix A for step-by-step instructions.
Generate a sample invoice using sendInvoice method and provider_token that you got from step 1. As of v1.0.0 no other options are needed for provider, except provider token.

Basic test card numbers

Genuine card information cannot be used in test mode. Instead, use any of the following test cards and a valid expiration date to create a successful payment.

Number	Brand	Date	Phone number
8600 1404 0738 9072	UzCard	10/24	998*****6998
9860 0901 0131 2172	Humo	03/24	998*****3929

Transaction verification

To verify the payment you must verify the SMS code, which will be sent to the Telegram channel.

Going Live

Obtaining merchant token

After signing a contract with GlobalPay, you will be presented with a merchant token, which will be used for authorization purposes.

Authorization

To get into authorization interface follow instructions on Appendix A and choose Connect GlobalPay Live in step 6. Afterwards, you will be given a button with an unique link to merchant authorization interface, where you should use your merchant token to authorize. In case of a successful authorization, you will be redirected back to BotFather, where you can get a provider_token.

NOTE: test cards given above will not work on LIVE. So, you must use a real card.

Additional Information

Only UzCard and Humo cards are supported
Only UZS is supported, so make sure you set currency as UZS in your invoice
Prices for items, as well as for tips must be given in tiyins (multiply the original price by 100)

Appendices

Appendix A: Obtaining `provider_token`

Go to BotFather
Type /mybots to get the list of available bots
Select your bot that you want to connect to GlobalPay
Next, select Payments
Afterwards, select GlobalPay from the list of payment providers
If you want to test your integration, select Connect GlobalPay Test, otherwise select Connect GlobalPay Live
After successful connection, your provider_token will be available on the main menu of Payments section (see step 4)