Overview

TBC QR Payment Service

Product Overview

TPAY QR is a fast and secure payment service that allows you to easily receive payments from TBC Bank Mobile Bank customers.

✓ Easy to use
✓ Ability to manage transactions online

📘

NOTE:

Payment will be credited to your account the following business day.

---

API Overview

Endpoint Addresses:

All endpoints are structured according to the following pattern:
{base-url}/{api-version}/{product}/{sub-product}

Base URL

• Test service Base URL: https://test-api.tbcbank.ge
• Production service Base URL: https://api.tbcbank.ge

API Version

current version: v1

Product endpoints

• QRPayment: /qr/payments
  Request initiates QR payment. Returned qrCode value (url) should be converted to QR code by the developer app.
• QRPaymentStatus: /qr/payments/{payment_id}
  Request returns QR payment status. Value of corresponding QR payment_id should be passed as a parameter in request url.
• Token: /access-token
  To request access token for executing Tpay payments, client_id and client_secret values should be passed as a form parameters in body. Received token value should then be added as an Authorization Header for other methods.

Authorizing Requests:

• All requests should contain apikey parameter with corresponding developer app key value in a Header.
• apikey parameter is used to verify registered developer app and grant general access to make api call. To get your developer app key, follow instructions at Creating developer account.

Testing services:

• Postman collection with test services can be downloaded from the following link: Tpay Payment API Test Services Collection

Resource Types:

• URIs are relative to https://test-api.tbcbank.ge/v1/tpay, unless otherwise noted.

---

Steps to follow for TBC QR Payments integration:

• Register your company as a merchant to obtain your Merchant Credentials
• Create a developer account on the developer portal to obtain your API key and Secret
• Integrate TBC QR Payments
• Test the service
• Go Live