API Overview

API Overview

Methods for integrating TBC E-Commerce service into your e-commerce solution.

Endpoint Addresses:

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

Base URL

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

API Version

current version: v1

Product endpoints

• Get Access Token: /tpay/access-token
  Gets access-token for accessing TBC E-Commerce resources. TBC E-Commerce merchant parameters - client_id and client_secret values should be passed as a form parameters in body.
• Create Payment: /tpay/payments
  Request initiates TBC E-Commerce web payment.
• Get Payment Details: /tpay/payments/{payId}
  Request returns payment status and details for given payId.
• Cancel Payment: /tpay/payments/{payId}/cancel
  Request cancels payment for given payId
• Complete Pre-authorization: /payments/{payId}/completion
  Request completes authorization process for payment with given payId.
• Execute Recurring Payment: /payments/execution
  Request initiates recurring payment.
• Delete Recurring Payment: /tpay/payments/{recId}/delete
  Request deletes recurring payment for given recurring payment id recId.

Authorizing Requests:

apikey

• 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.

access token

• In order to execute TBC E-Commerce Services, you must be registered as a TBC E-Commerce Merchant.
• access token is needed for executing TBC E-Commerce 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.

Testing services:

• Postman collection with test services can be downloaded from the following link: TBC E-Commerce API Services Collection