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
Updated about 3 years ago