API Overview

Endpoint Addresses

Production service url: https://api.tbcbank.ge

Base Path:

/v1/tpay/

Sample requests:

Postman collection and preconfigured environment can be downloaded from the following link: TBC POS QR API Services Collection

Authorizing Requests

Apikey
All requests should contain apikey parameter with corresponding developer app key value passed in the Request Header. apikey parameter is used to verify registered developer app and grant general access to Open API platform. To get your API key, follow instructions at developers.tbcbank.ge/get-started.

Access Token
In order to execute TBC POS QR Services, you must be registered as a TBC POS QR Merchant.

After merchant activation, detailed instructions will be sent to the registered company email.

After TBC POS QR merchant account is validated and activated by back office users in TBC Merchant system, you can get your merchant client_id and client_secret parameters from the TBC Checkout Merchant Dashboard .

Access token is needed for executing TBC POS QR payment methods. Token can be obtained by executing /tpay/access-token request, with corresponding client_id and client_secret parameters, as described below. Received token value should then be passed in an Authorization Header for other methods. Token is valid within 1 day.